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 β¦