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": …