Skip to content

Cletrix-Labs/Clextron

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Clextron Logo

🤖 Clextron

Autonomous AI Agents for Students Worldwide

Python LangChain Gemini API FastAPI License: MIT Open Source

Clextron is an open-source platform of autonomous AI agents built for students across the globe.
Research smarter. Study faster. Grow further - in your own language.

🚀 Live Demo · 📖 Documentation · 🐛 Report Bug · 💡 Request Feature



🌟 What is Clextron?

Most AI tools make students ask the same questions again and again.
Clextron is different.

Clextron runs autonomous AI agents that act on your behalf - researching topics, summarizing papers, building study plans, and preparing you for your career - without you having to prompt every single step.

Think of it as having a team of expert AI assistants working for you, 24/7, in your own language.


✨ Features

Agent What it does
Research Agent Searches, reads, and summarizes academic topics automatically
Language Agent Explains any concept in 50+ languages
Study Planner Agent Builds a personalized study schedule based on your goals
Career Agent (coming soon) Resume review, job search, and interview prep
Quiz Agent (coming soon) Generates smart questions from your notes

🎯 Who is this for?

  • Engineering & CS students who need to research fast
  • Non-English speaking students who want AI in their language
  • Any student who wants to study smarter, not harder
  • Developers who want to contribute to open-source AI

🚀 Quick Start

1. Clone the repository

git clone https://github.com/Cletrix-Labs/Clextron.git
cd Clextron

2. Install dependencies

pip install -r requirements.txt

3. Set up your API key

Create a .env file in the root folder:

GEMINI_API_KEY=your_gemini_api_key_here

Get your free Gemini API key at aistudio.google.com

4. Run the app

uvicorn app:app --reload

Open your browser at http://localhost:8000 - Clextron is running! 🎉


🗂️ Project Structure

Clextron/
│
├── agents/                  # AI agent logic
│   ├── research_agent.py    # Research & summarization agent
│   ├── language_agent.py    # Multilingual explanation agent
│   └── planner_agent.py     # Study planner agent
│
├── templates/               # HTML frontend pages
├── static/                  # CSS and JavaScript
├── modules/                 # Helper utilities
│
├── app.py                   # FastAPI main application
├── requirements.txt         # Python dependencies
├── .env                     # API keys (never commit this!)
├── .gitignore
├── LICENSE
└── README.md

🛠️ Tech Stack

Technology Purpose
Python 3.10+ Core language
FastAPI Backend API framework
LangChain AI agent framework
Google Gemini API Free AI language model
python-dotenv Environment variable management
HTML / CSS / JS Frontend interface

🌍 Multilingual Support

Clextron is built for global students. Currently supported languages include:

English Hindi Tamil Telugu Spanish French Portuguese Arabic Chinese Japanese Korean German Italian Russian + more coming soon


🤝 Contributing

We welcome contributors of all skill levels!

How to contribute

  1. Fork the repository
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Make your changes and commit: git commit -m "feat: add your feature"
  4. Push to your branch: git push origin feature/your-feature-name
  5. Open a Pull Request

Good first issues

Look for issues tagged good-first-issue - perfect for beginners!

Please read our Contributing Guide before submitting.


📋 Roadmap

  • Project setup and structure
  • Research Agent (v1)
  • Multilingual language support
  • Study Planner Agent
  • Career Agent
  • Quiz Generator Agent
  • Web UI (HTML/CSS frontend)
  • Deploy to Render.com
  • Mobile-friendly interface
  • Agent memory (remembers your progress)

📸 Screenshots

Screenshots coming soon as the UI is built!


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


🙏 Acknowledgements

  • LangChain - for the amazing agent framework
  • Google Gemini - for the free AI API
  • FastAPI - for the blazing fast backend
  • Every student who inspired this project 💙

Built with ❤️ by Cletrix Labs

⭐ If you find this useful, star the repo - it helps more students find it!

GitHub stars GitHub forks

About

🤖 Autonomous AI agents for students worldwide - multilingual, open source. Built with Python, LangChain & Gemini API.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors