How lithinpavansai/ai_builder_backend works
App Compiler is a FastAPI backend that turns a natural-language app request into a structured, validated app schema. The primary flow enters through the generation API, passes through intent extraction, system design, schema generation, refinement, and validation/repair, then returns the result; async jobs expose progress and completed results. The README also documents runtime executability checks and prompt evaluation. Pipeline-stage links are supported by the README’s architecture description; sampled source shows orchestration and selected component calls, but not every route or stage implementation in full.
Main entry points: repair.py Pipeline Orchestrator · runner.py Prompt Evaluation · gemini.py Groq LLM Client · models.py Schema Contracts
Components 19
API & Jobs
- Generation API
app/routes/generate.py - Async Job Store
app/utils/job_store.py - Evaluation API
app/routes/generate.py
Schema Pipeline
- Pipeline Orchestrator
app/validators/repair.py - Intent Extraction
app/pipeline/intent.py - System Design
app/pipeline/system_design.py - Schema Generation
app/pipeline/schema_gen.py - Schema Refinement
app/pipeline/refinement.py
Validation & Quality
- Schema Contracts
app/validators/models.py - Schema Validation
app/validators/validator.py - Validation Repair
app/validators/repair.py - Retry Orchestrator
app/validators/orchestrator.py - Runtime Validator
app/validators/runtime_validator.py
LLM & Evaluation
- Groq LLM Client
app/utils/gemini.py - LLM Configuration
app/utils/config.py - Prompt Evaluation
app/evaluation/runner.py - Evaluation Prompts
app/evaluation/test_prompts.py - Evaluation Results
app/evaluation/results.json
Other components
- API Client
Connections 29
- API Client → Generation API: submits prompt
README.md - Generation API → Retry Orchestrator: runs pipeline
app/routes/generate.py - Retry Orchestrator → Pipeline Orchestrator: runs with repair
app/validators/orchestrator.py - Pipeline Orchestrator → Intent Extraction: extracts intent
app/validators/repair.py - Pipeline Orchestrator → System Design: designs system
app/validators/repair.py - Pipeline Orchestrator → Schema Generation: generates schema
README.md - Pipeline Orchestrator → Schema Refinement: refines schema
README.md - Intent Extraction → Groq LLM Client: requests completion
app/pipeline/intent.py - System Design → Groq LLM Client: requests completion
app/pipeline/system_design.py - Schema Generation → Groq LLM Client: requests completion
app/pipeline/schema_gen.py - Schema Refinement → Groq LLM Client: requests completion
app/pipeline/refinement.py - Groq LLM Client → LLM Configuration: reads settings
app/utils/gemini.py - Intent Extraction → Schema Contracts: validates output
app/pipeline/intent.py - System Design → Schema Contracts: validates output
app/pipeline/system_design.py - Schema Generation → Schema Contracts: builds schema
app/pipeline/schema_gen.py - Schema Refinement → Schema Contracts: checks schema
app/pipeline/refinement.py - Pipeline Orchestrator → Schema Validation: validates stages
app/validators/repair.py - Pipeline Orchestrator → Validation Repair: repairs invalid output
app/validators/repair.py - Validation Repair → Groq LLM Client: requests correction
app/validators/repair.py - Retry Orchestrator → Schema Contracts: serializes result
app/validators/orchestrator.py - Generation API → Async Job Store: tracks async jobs
app/routes/generate.py - Generation API → Runtime Validator: checks executability
app/routes/generate.py - API Client → Evaluation API: submits eval request
README.md - Evaluation API → Prompt Evaluation: runs evaluation
app/routes/generate.py - Prompt Evaluation → Evaluation Prompts: loads prompts
app/evaluation/runner.py - Prompt Evaluation → Evaluation Results: writes report
app/evaluation/runner.py - Prompt Evaluation → Intent Extraction: runs pipeline stage
app/evaluation/runner.py - Prompt Evaluation → System Design: runs pipeline stage
app/evaluation/runner.py - Prompt Evaluation → Runtime Validator: scores runtime
app/evaluation/runner.py