Ama is a fine-tuned AI assistant that speaks Twi (Ghana's most widely spoken language) and English. Built on Qwen/Qwen3.5-9B model with an agentic tool system
# π¬π Twi AI - Ama
> **The first bilingual Twi-English AI agent with tools**
Created by **Angelo Asante**
---
## π― What is Ama?
Ama is a fine-tuned AI assistant that speaks **Twi** (Ghana's most widely spoken language) and **English**. Built on Meta's Llama 3.1 8B model with an agentic tool system, Ama can:
- π¬ Have natural conversations in Twi and English
- π Search the web for current information
- π Fetch and analyze web pages
- πΌοΈ Search for images
- π Tell time in any timezone worldwide
- π Create, view, and manage files
- π Access Akan cultural knowledge base
- π Translate between Twi and English
---
## π Quick Start - Agent API
Ama is available via **two endpoints** - choose based on your needs:
| Endpoint | Best For | Cold Start | Cost |
|----------|----------|------------|------|
| **HuggingFace** | Production, lower cost | ~30-60s | $0.80/hr (GPU time) |
| **Modal** | Development, testing | ~30-60s | ~$0.001-0.003/req |
### π€ HuggingFace Inference Endpoint (Recommended)
```
vs68t0qrfr3hsfp3.us-east-1.β¦
```
### β‘ Modal Endpoint (Alternative)
```
angeloasante--twi-ai-agent-β¦
```
### Health Check (Modal)
```
angeloasante--twi-ai-agent-β¦
```
---
## π‘ API Examples
### Basic Chat - HuggingFace (curl)
```bash
curl -X POST
vs68t0qrfr3hsfp3.us-east-1.β¦ \
-H "Authorization: Bearer YOUR_HF_TOKEN" \
-H "Content-Type: application/json" \
-d '{"inputs": "Wo ho te sΙn?"}'
```
### Basic Chat - Modal (curl)
```bash
curl -X POST
angeloasante--twi-ai-agent-β¦ \
-H "Content-Type: application/json" \
-d '{"message": "Wo ho te sΙn?"}'
```
### Python Example - HuggingFace (Recommended)
```python
import requests
HF_URL = "
vs68t0qrfr3hsfp3.us-east-1.β¦"
HF_TOKEN = "your_huggingface_token" # Get from
huggingface.co
headers = {
"Authorization": β¦