Adwa AI is a full-stack AI assistant focused on the Battle of Adwa and Ethiopian history. It uses a Retrieval-Augmented Generation (RAG) approach to deliver accurate, context-aware answers grounded in historical documents.
# ADWA AI
adwa-ai-assistant-3.onrende…
Adwa AI is a full-stack AI assistant focused on the Battle of Adwa and Ethiopian history.
It uses a Retrieval-Augmented Generation (RAG) approach to deliver accurate, context-aware answers grounded in historical documents.
The goal is simple: make one of Ethiopia’s most important historical victories accessible, searchable, and intelligently explorable.
## Features
#### History-focused AI assistant
Specialized in the Battle of Adwa and related Ethiopian history.
#### RAG-based architecture
Answers are generated from a curated knowledge base, not just generic AI output.
#### Full-stack application
Simple frontend + Python backend for seamless interaction.
#### Lightweight & easy to run
Minimal setup required.
## Getting Started
#### 1. Clone the repository
git clone
github.com
#### 2. Navigate into the project
cd ADWA-AI-Assistant
cd backend
#### Environment Variables
Create a .env file
Inside the backend/ directory, create a file named:
.env
##### Add your Groq API Key
GROQ_API_KEY=XXXXXXXXXXXXXXXXXX
#### 3. Run the backend
python index.py
python app.py
Make sure you have Python installed and required dependencies configured.
## Tech Stacks:
frontend : html,css and js
backend : python, flask