Hugging Face's logo

Spaces:
AmaniQuery
/
README
Configuration error

App Files Community
README
File size: 3,241 Bytes
2e8c459
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
---
title: AmaniQuery
emoji: 🔍
colorFrom: blue
colorTo: green
pinned: true
---

<div align="center">

# 🔍 AmaniQuery

**AI-Powered Legal & Policy Research Assistant for Kenya**

[![Backend](https://img.shields.io/badge/Backend-Go-009688?style=for-the-badge&logo=fastapi)](https://huggingface.co/spaces/AmaniQuery/amaniquery-backend)
[![Voice](https://img.shields.io/badge/Voice-VibeVoice-9C27B0?style=for-the-badge&logo=microsoft)](https://huggingface.co/spaces/AmaniQuery/amaniquery-vibevoice)
[![Docs](https://img.shields.io/badge/Docs-WeKnora-FF9800?style=for-the-badge&logo=go)](https://huggingface.co/spaces/AmaniQuery/amaniquery-weknora)

</div>

---

## 🎯 What is AmaniQuery?

AmaniQuery is a **RAG-powered research platform** that makes Kenyan legal documents, parliamentary proceedings, and policy information accessible through natural language queries.

### ✨ Features

- 🔍 **Intelligent Search** - Query laws, bills, and parliamentary hansards using natural language
- 🤖 **AI-Powered Answers** - Get synthesized responses with source citations
- 🎤 **Voice Interface** - Ask questions and get spoken responses
- 📄 **Document Processing** - Upload and analyze legal documents
- 📊 **Research Reports** - Generate comprehensive research summaries
- 🔐 **Secure API** - JWT authentication for enterprise use

---


## 🛠️ Technology Stack

```
┌─────────────────────────────────────────────────────────┐
│                     AmaniQuery                          │
├─────────────────────────────────────────────────────────┤
│  🔍 Backend      │  FastAPI + LangGraph + RAG Pipeline  │
│  🎤 Voice        │  Microsoft VibeVoice TTS             │
│  📄 Documents    │  WeKnora (Tencent RAG Framework)     │
│  🧠 LLM          │  Moonshot / Gemini / OpenAI          │
│  📊 Vector Store │  Qdrant / Upstash                    │
│  🗄️ Database     │  PostgreSQL                          │
└─────────────────────────────────────────────────────────┘
```

---

## 📖 API Usage

### Query the Knowledge Base
```bash
curl -X POST https://amaniquery-backend.hf.space/api/v1/query \
  -H "Content-Type: application/json" \
  -d '{"query": "What does the Kenya Constitution say about land rights?"}'
```

### Text-to-Speech
```bash
curl -X POST https://amaniquery-vibevoice.hf.space/api/v1/voice/speak \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from AmaniQuery", "voice": "Wayne"}'
```

---

## 🤝 Contributing

We welcome contributions! Check out our [GitHub repository](https://github.com/AmaniQuery/amaniquery) to get started.

---

## 📄 License

MIT License - See [LICENSE](https://github.com/AmaniQuery/amaniquery/blob/master/LICENSE) for details.

---

<div align="center">

**Made with ❤️ for Kenya**

*Empowering citizens with accessible legal information*

</div>