|
1 | | -# EduAgent |
2 | | -An interactive tutoring and assiting platform made with love and AI Agents. |
| 1 | +# EduAssistant |
| 2 | + |
| 3 | +Education is the foundation of progress, yet students and educators often struggle with processing and understanding complex educational materials efficiently. The challenge lies in effectively summarizing content, creating assessments, and finding relevant references - tasks that are time-consuming and require significant effort. |
| 4 | + |
| 5 | +EduAgent is an intelligent educational platform that leverages AI to transform how we learn and teach. By automating content summarization, quiz generation, and reference finding, EduAgent helps students grasp complex topics faster and assists educators in creating better learning materials. |
| 6 | + |
| 7 | +## Problem that I am trying to solve |
| 8 | + |
| 9 | +Students and educators face several challenges in the learning process: |
| 10 | +- Processing large volumes of educational content can be overwhelming |
| 11 | +- Creating meaningful assessments and quizzes is time-consuming |
| 12 | +- Finding relevant references and citations requires extensive research |
| 13 | +- Maintaining engagement with study materials can be difficult |
| 14 | + |
| 15 | +EduAgent addresses these challenges by providing AI-powered tools that automate these tasks, allowing users to focus on understanding and applying knowledge rather than spending time on mechanical tasks. |
| 16 | + |
| 17 | +## How to use EduAgent |
| 18 | + |
| 19 | +1. Visit the EduAgent web application (live link on the side of the github page) |
| 20 | +2. Upload or paste your educational content |
| 21 | +3. Choose from our AI-powered tools: |
| 22 | + - **Summarizer**: Get concise summaries of your content |
| 23 | + - **Quiz Generator**: Create multiple-choice questions automatically |
| 24 | + - **Reference Finder**: Discover relevant citations and references |
| 25 | +4. Download or save your results for future reference |
| 26 | + |
| 27 | +## Technologies Used |
| 28 | + |
| 29 | +### Frontend |
| 30 | + |
| 31 | +#### Next.js 14 |
| 32 | +Next.js provides server-side rendering and static site generation capabilities, ensuring fast loading times and SEO optimization. Its file-based routing system makes the application structure intuitive and maintainable. |
| 33 | + |
| 34 | +#### TypeScript |
| 35 | +TypeScript adds static typing to JavaScript, improving code quality and developer experience by catching errors during development and enabling better code completion and documentation. |
| 36 | + |
| 37 | +#### Tailwind CSS |
| 38 | +Tailwind's utility-first approach allows for rapid UI development with a consistent design system, making it easy to create responsive and accessible interfaces. |
| 39 | + |
| 40 | +### Backend |
| 41 | + |
| 42 | +#### FastAPI |
| 43 | +FastAPI is a modern, fast (high-performance) web framework for building APIs with Python 3.7+ based on standard Python type hints. It provides automatic interactive API documentation and is built on Starlette and Pydantic. |
| 44 | + |
| 45 | +#### Agent Development Kit (ADK) |
| 46 | +The Agent Development Kit (ADK) is a flexible and modular framework for developing and deploying AI agents. While optimized for Gemini and the Google ecosystem, ADK is model-agnostic and deployment-agnostic. We use ADK to create specialized agents for summarization, quiz generation, and reference finding, enabling complex coordination and delegation between different AI capabilities. |
| 47 | + |
| 48 | +#### Docker |
| 49 | +Docker containerization ensures consistent environments across development, testing, and production, making deployment and scaling more straightforward. |
| 50 | + |
| 51 | +## How to run the app locally |
| 52 | + |
| 53 | +1. **Clone the repository** |
| 54 | + ```bash |
| 55 | + git clone https://github.com/your-username/EduAgent.git |
| 56 | + cd EduAgent |
| 57 | + ``` |
| 58 | + |
| 59 | +2. **Set up the backend** |
| 60 | + ```bash |
| 61 | + cd backend |
| 62 | + python -m venv venv |
| 63 | + source venv/bin/activate # On Windows: .\venv\Scripts\activate |
| 64 | + pip install -r requirements.txt |
| 65 | + ``` |
| 66 | + |
| 67 | +3. **Set up the frontend** |
| 68 | + ```bash |
| 69 | + cd ../frontend |
| 70 | + npm install |
| 71 | + ``` |
| 72 | + |
| 73 | +4. **Configure environment variables** |
| 74 | + - Copy `.env.example` to `.env` in both `backend` and `frontend` directories |
| 75 | + - Update the variables with your configuration |
| 76 | + |
| 77 | +5. **Start the development servers** |
| 78 | + - Backend: `cd backend && uvicorn main:app --reload` |
| 79 | + - Frontend: `cd frontend && npm run dev` |
| 80 | + |
| 81 | +6. Open [http://localhost:9001](http://localhost:9001) in your browser |
| 82 | + |
| 83 | +## Contributing |
| 84 | + |
| 85 | +We welcome contributions! To contribute to EduAgent: |
| 86 | + |
| 87 | +1. Fork the repository |
| 88 | +2. Create a feature branch (`git checkout -b feature/your-feature`) |
| 89 | +3. Commit your changes (`git commit -m 'Add some feature'`) |
| 90 | +4. Push to the branch (`git push origin feature/your-feature`) |
| 91 | +5. Open a Pull Request |
0 commit comments