Abby - An AI agent built with Google ADK to help persons with disabilities discover accessible services across Kenya. Part of the AbiliLife ecosystem.
# Abby - AI Agent for AbiliLife
**Abby** is an intelligent AI agent built with Google's Agent Development Kit (ADK) to help persons with disabilities (PWDs) discover accessible services across Kenya.
---
## 🎯 Purpose
Abby serves as the conversational AI backend for **AbiliLife**, an inclusive super-app. The agent helps users discover:
- 🏥 **Healthcare**: Accessible clinics and medical facilities
- 💼 **Employment**: Job opportunities for PWDs
- 🚗 **Transport**: Accessible ride-hailing and public transport
- 📚 **Education**: Inclusive learning centers and skills training
- 🛒 **Marketplace**: Assistive devices and accessibility products
---
## 🏗️ Project Structure
```
AbiliLife-agent/
├── abby/ # Main agent package
│ ├── agent.py # Root agent definition
│ ├── tools.py # Tool functions for data retrieval
│ ├── data/
│ │ └── accessible_services.json # Mock service data
│ └── __init__.py
├── test_agent.py # Test script
├── requirements.txt # Python dependencies
├── .env # Environment variables (not in repo)
├── .gitignore # Git ignore rules
├── README.md # This file
└── ARCHITECTURE.md # Technical architecture documentation
```
---
## 🚀 Getting Started
### Prerequisites
- Python 3.9 or higher
- Google AI API Key (Get one here)
- Git
### Installation
1. **Clone the repository**
```bash
git clone
github.com
cd AbiliLife-agent
```
2. **Create virtual environment**
```bash
python -m venv venv
# Windows
.\venv\Scripts\Activate.ps1
# Linux/Mac
source venv/bin/activate
```
3. **Install dependencies**
```bash
pip install -r requirements.txt
```
4. **Configure API key**
Create a `.env` file in the project root:
```env
GOOGLE_API_KEY=your_google_api_key_here
```
### Running Abby
#### Option 1: ADK Web Interface (Recommended)
```bash
ad …