How devalous17/ai-finals works
AI Software Factory is a prototype for turning a user brief and chosen design direction into a generated website. The workflow runs from the dashboard to the FastAPI build endpoint, which creates a lightweight plan, requests a complete page from Gemini, converts inline assets into editable frontend files, and serves the saved project. The dashboard also loads provider status and design presets and displays build results. Backend, database, testing, and repair stages are explicitly planned, not implemented; Groq is available for future support tasks, not website generation. Wiring reflects the README and sampled source; unsampled details are omitted.
Main entry points: main.py Build API · main.jsx Build dashboard · router.py LLM router · generator.py Project generator
Components 18
Dashboard
- Build dashboard
frontend/src/main.jsx
Build workflow
- Build API
backend/main.py - Design presets
backend/presets.py - Brief planner
agents/manager.py - HTML validation
backend/generator.py
LLM integration
- LLM router
llm/router.py - Provider types
llm/base.py - Gemini provider
llm/providers.py - Groq provider
llm/providers.py - Mock provider
llm/mock.py
Generated website
- Project generator
backend/generator.py - Frontend file writer
backend/project_layout.py - Saved projects
- Generated app server
backend/main.py
Other components
- User
- Generated website
- Gemini API
- Groq API
Connections 22
- User → Build dashboard: enters brief
- Build dashboard → Build API: submits build
- Build dashboard → Build API: requests status
- Build dashboard → Build API: loads presets
- Build API → Design presets: reads choices
- Build API → Brief planner: plans brief
- Brief planner → LLM router: holds router
- Build API → LLM router: generates HTML
- LLM router → Gemini provider: dispatches
- LLM router → Mock provider: falls back
- Gemini provider → Gemini API: requests content
- Groq provider → Groq API: requests content
- LLM router → Groq provider: routes support
- Build API → HTML validation: validates response
- Build API → Project generator: saves valid page
- Project generator → HTML validation: extracts page
- Project generator → Frontend file writer: writes frontend
- Frontend file writer → Saved projects: writes files
- Build API → Generated app server: mounts projects
- Build dashboard → Generated app server: opens generated app
- Generated app server → Generated website: serves website
- Build API → Build dashboard: returns build result