How thirumalai-tech-developer/ai-agent works
This repository is an AI front-end scaffolding pipeline: a user prompt is planned into an application blueprint, compiled into component tasks, written into a React project, checked, and—when runtime errors occur—repaired. Its principal orchestration is in main.py; memory, provider-key routing, and JSON parsing support that workflow. The README documents the main stages and the template stack, while several listed utility modules were not excerpted, so their internal connections are left unspecified.
Main entry points: main.py Pipeline runner · error_fixer.py Runtime healer · memory.py Agentic memory · assigner.py Code assigner
Components 18
Pipeline orchestration
- Pipeline runner
main.py - Agentic memory
utils/memory.py - API key router
utils/key_router.py - LLM router
utils/llm_router.py
Planning and generation
- Blueprint planner
utils/planner.py - Planner v2
utils/planner_v2.py - Task executor
utils/executor.py - Executor v2
utils/executor_v2.py - Output extractor
utils/extractor.py - JSON repair
utils/json_utils.py - Code assigner
utils/assigner.py
Validation and healing
- Static validator
utils/validator.py - Runtime healer
utils/error_fixer.py - Error solver
utils/error_solver.py
Frontend template
- React app shell
template/web/src/App.tsx - React entry
template/web/src/main.tsx
Other components
- User
- Headless browser
Connections 13
- User → Pipeline runner: submits prompt
Readme.md - Pipeline runner → Blueprint planner: requests plan
Readme.md - Pipeline runner → Task executor: builds tasks
Readme.md - Pipeline runner → Code assigner: writes code
Readme.md - Pipeline runner → Static validator: checks project
Readme.md - Pipeline runner → Runtime healer: starts healing
Readme.md - Pipeline runner → Agentic memory: loads context
main.py - Pipeline runner → API key router: uses routing
main.py - Pipeline runner → JSON repair: uses parsing
main.py - Runtime healer → Headless browser: checks console
utils/error_fixer.py - Runtime healer → Agentic memory: reads context
utils/error_fixer.py - Runtime healer → Code assigner: applies fixes
utils/error_fixer.py - React entry → React app shell: renders app
template/web/src/main.tsx