Skip to content

ammumoh/agentic-codebase-genius

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧠 Codebase Genius

Codebase Genius is an intelligent agent that maps, analyzes, and documents code repositories automatically. It leverages Python and AI-based summarization to help developers understand large codebases faster.


πŸš€ Features

  • 🧩 Repository Mapper: Scans your project and generates a dependency tree.
  • πŸ“„ Auto Documentation: Summarizes and documents functions and modules.
  • πŸ€– AI Integration: Uses LLMs for code insights and file analysis.
  • ⚑ Fast CLI Execution: Run tasks directly from the command line using JAC scripts.
  • 🧱 Modular Design: Clean backend (Python) and frontend (React/Vite) separation.

πŸ—οΈ Project Structure

Codebase-Genius/ β”‚ β”œβ”€β”€ backend/ # Python backend logic β”œβ”€β”€ frontend/ # React-based frontend UI β”œβ”€β”€ .gitignore # Ignored files (including .env) β”œβ”€β”€ requirements.txt # Python dependencies └── README.md # Project overview


βš™οΈ Setup Instructions

Backend (Python)

cd backend
python3 -m venv venv
source venv/bin/activate   # or venv\Scripts\activate on Windows
pip install -r requirements.txt

Frontend (React)
cd frontend
npm install
npm run dev

πŸ§‘β€πŸ’» Author

Elijah Mumo Muthui
IT Guru | Robotics & AI Enthusiast
πŸ“ , Kenya


🧾 License

This project is for educational and demonstration purposes only.

About

Codebase Genius is an AI-powered, multi-agent system designed to automatically analyze any GitHub repository and generate clear, structured documentation. It combines repository mapping, README summarization, and intelligent code inspection to deliver quick insights into complex software projects.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages