README.md

# ConfamNode 🇳🇬

**The Nigerian AI inference gateway**

ConfamNode gives Nigerian developers and businesses access 
to leading AI models — billed in Naira, not USD.

## Models Hosted Here

This organization hosts the open-source models that power 
ConfamNode's local inference tier — running entirely on 
Nigerian hardware, data never transmitted abroad.

### Powering ConfamNode Today

| Model | Powers |
|---|---|
| [Qwen3.5-4B](https://huggingface.co/confamnode/Qwen3.5-4B) / [GGUF](https://huggingface.co/confamnode/Qwen3.5-4B-GGUF) | `confam-nano` — runs on Jetson Orin Nano |
| [EmbeddingGemma-300m](https://huggingface.co/confamnode/embeddinggemma-300m) / [GGUF](https://huggingface.co/confamnode/embeddinggemma-300m-GGUF) | `confam-embed-text-local` — local CPU embeddings |

### Healthcare AI — Under Evaluation

| Model | Use Case |
|---|---|
| [MedGemma 1.5 4B](https://huggingface.co/confamnode/medgemma-1.5-4b-it) / [GGUF](https://huggingface.co/confamnode/medgemma-1.5-4b-it-GGUF) | Medical text and image understanding |
| [MedGemma 4B](https://huggingface.co/confamnode/medgemma-4b-it) / [GGUF](https://huggingface.co/confamnode/medgemma-4b-it-GGUF) | Medical text and image understanding |

We're evaluating MedGemma for a future **confam-med** model 
— local, NDPA-aware AI for Nigerian hospitals and clinics, 
keeping sensitive patient data on Nigerian soil.

### Under Evaluation

We maintain mirrors of additional open-source models — 
including Gemma 4, Qwen3-4B, and Ministral-3 — as candidates 
for future local ConfamNode deployments.

## What ConfamNode Offers

- **Cloud models** — aggregated access to Gemini, DeepSeek, 
  and other leading AI models via a single API
- **Local models** — AI running entirely on Nigerian 
  hardware, for businesses requiring data residency 
  (banks, fintechs, healthcare, government)
- **Naira billing** — pay-as-you-go, no USD, no subscriptions

## Get Started

```bash
pip install confamnode
```

```python
from confamnode import ConfamNode

client = ConfamNode(api_key="confam-sk-xxx")
ansa = client.gist(model="confam-nano", messages="How far?")
print(ansa.text)
print(ansa.is_local)  # True
```

## Links

- PyPI: [pypi.org/project/confamnode](https://pypi.org/project/confamnode)
- GitHub: [github.com/confamnodeai](https://github.com/confamnodeai)
- Contact: hello@confamnode.com

---

Built in Abuja, Nigeria by [JoTeq the First](https://github.com/confamnodeai)