Apppublic

malimba/Apollo-companion

sourceHugging Faceupdated 9mo agoView on Hugging Face

0likes

App README

APOLLO

AI-Powered Study Companion

Apollo transforms your study materials into an interactive learning experience. Upload documents, let AI extract key topics, and test your knowledge with automatically generated quizzes.

Features

—Document Processing — Upload PDF, DOCX, or TXT files for automatic analysis
—AI Topic Extraction — Google Gemini identifies and summarizes key concepts
—Smart Quiz Generation — Multiple choice, true/false, and flashcard formats
—Knowledge Tracking — Monitor mastery scores across topics
—RAG-Powered Context — Semantic search using sentence-transformers embeddings

Tech Stack

Component	Technology
Backend	Django 5.x
Database	PostgreSQL + pgvector
AI/LLM	Google Gemini API
Embeddings	sentence-transformers/all-MiniLM-L6-v2
Task Queue	Celery + Redis (optional)

Quick Start

bash

# Clone and setup
git clone <repo-url>
cd APOLLO

# Create virtual environment (Python 3.12 recommended)
python3.12 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Setup database
createdb apollo_db
python manage.py migrate

# Run server
python manage.py runserver

See SETUP.md for detailed installation instructions.

Documentation

—SETUP.md — Installation and configuration guide
—TECHNICAL.md — Architecture, API endpoints, and database schema

License

MIT