Devfest-2025/compusly-ai

Compusly AI is a backend API service designed to help students navigate complex university administrative procedures. Built with modern AI technology, it provides instant answers about office locations, procedures, required documents, and schedules across Algerian universitie # Compusly AI **AI-Powered Administrative Assistant for Algerian Universities** Compusly AI is a backend API service designed to help students navigate complex university administrative procedures. Built with modern AI technology, it provides instant answers about office locations, procedures, required documents, and schedules across Algerian universities. ## Overview This project addresses a critical challenge faced by students in Algerian universities: navigating complex administrative procedures across multiple offices. Students often struggle to find the right bureau, understand required documents, or know office hours. Compusly AI solves this by providing an intelligent assistant that delivers accurate, contextual information about university administrative services. ### Key Features - **Administrative Q&A**: Intelligent responses about university procedures, office locations, and requirements - **Multi-University Support**: Pre-configured data for USTHB, Batna 2, and extensible to other institutions - **Fast Response Time**: Powered by Groq's high-performance inference - **RESTful API**: Clean, documented endpoints for easy integration - **Docker Support**: Containerized deployment for production environments ## Technology Stack **Backend Framework** - FastAPI 0.108.0 - Modern, high-performance web framework - Uvicorn - ASGI server for production deployment - Python 3.13 - Latest stable Python release **AI & NLP** - Groq API - Fast AI inference with GPT-OSS-120B model - LangChain & LangGraph - Agent orchestration and workflow management **Document Processing** - PyPDF2 - PDF text extraction - Pillow - Image processing capabilities **Development Tools** - pytest - Comprehensive testing framework - Docker & Docker Compose - Containerization ## Quick Start ### Prerequisites - Python 3.11 or higher (3.13 recommended) - Groq API key (free tier available at console.groq.com) - 4GB RAM minimum - Docker (optional, for containerized deploy …