Skip to content

Commit 3aa4fe6

Browse files
committed
Updated README.MD
1 parent a7d881c commit 3aa4fe6

File tree

1 file changed

+91
-2
lines changed

1 file changed

+91
-2
lines changed

README.md

Lines changed: 91 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,91 @@
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

Comments
 (0)