A state-of-the-art autonomous software engineering platform that transforms natural language prompts into production-grade, tested, and self-healed full-stack codebases.
Multi-Agent LangGraph DAG • Ephemeral Docker Code Sandboxing • Automated Jest/Supertest/Pytest Harnesses • Real-Time Self-Healing Feedback Loops • Interactive Live App Preview • 1-Click GitHub & ZIP Export
UI Showcase • Key Capabilities • Architecture • Security & Sandboxing • Quick Start • API Reference • Author
Autonomous SWE Prompt Engine with presets, visual 5-Agent DAG pipeline, 9-stage task checklist, and multi-file code viewer.
Real-time containerized test execution catching assertion errors and automatically triggering developer agent self-healing loops.
Instant live application sandbox with responsive device switcher (Desktop, Tablet, Mobile), theme toggle, and interactive state.
Publish generated full-stack repositories directly to GitHub with automated manifests or download complete ZIP bundles.
Unlike naive single-prompt code generators, MyAppMyWeb orchestrates 5 specialized autonomous agents connected in a stateful execution graph:
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ 👑 Manager │ ──► │ 💻 Developer │ ──► │ 🧪 Tester │ ──► │ 🛡️ Reviewer │ ──► │ 📝 Doc Agent │
│ Spec & Task DAG│ │ Code Synthesis │ │ Docker Sandbox │ │ Security & AST │ │ README & OpenAPI│
└─────────────────┘ └──────────────────┘ └─────────────────┘ └──────────────────┘ └──────────────────┘
▲ │
└────── Failing Trace ─────┘
(Self-Healing Loop)
| Agent | Responsibility | Core Deliverables |
|---|---|---|
| 👑 Manager Agent | Natural Language Spec Decomposition | Technical Architecture, Tech Stack Selection, and 9-Stage Task Execution DAG |
| 💻 Developer Agent | Full-Stack Multi-File Synthesis | 15+ Source Files across Frontend (React/Next.js) & Backend (Express/FastAPI/MongoDB) |
| 🧪 Tester Agent | Automated Test Generation & Sandboxing | Unit & Integration Test Suites (Jest, Supertest, Pytest) executed in Docker |
| 🔄 Self-Healing Router | Failure Trace Inspection & Auto-Correction | Real-time AST error diagnosis and Before/After Git Diff patches |
| 🛡️ Reviewer Agent | Static Code Analysis & Security Audit | Grade A+ (96/100) Quality Scorecard, OWASP Top 10 compliance check |
| 📝 Doc Agent | Production-Ready Documentation | Comprehensive README, API documentation, and OpenAPI 3.0 specifications |
When an assertion fails inside the Docker test sandbox, the platform automatically intercepts the error, locates the failing line, and triggers a surgical repair:
flowchart TD
Tester["🧪 Tester Agent: Executes Test Suite in Docker"] --> AssertCheck{"All Tests Pass?"}
AssertCheck -- Yes --> Reviewer["🛡️ Reviewer Agent: Security & AST Audit"]
AssertCheck -- No --> TraceExtractor["Extract Failing File, Line Number & AssertionError"]
TraceExtractor --> DevPatch["💻 Developer Agent: Synthesizes Corrected Code"]
DevPatch --> DiffRecord["Record Unified Git Diff: Old vs Self-Healed"]
DiffRecord --> SandboxRetest["🐳 Docker Sandbox: Re-run Test Harness"]
SandboxRetest --> AssertCheck
Reviewer --> DocAgent["📝 Doc Agent: OpenAPI & Final Artifacts"]
- Responsive Viewport Toggles: Seamlessly test generated apps across
🖥️ Desktop (100%),💻 Tablet (720px), and📱 Mobile (375px). - Isolated Iframe Execution: Live interactivity without host machine contamination.
- Dynamic State Simulation: Add, filter, complete, and delete records in real-time.
- Theme Support: Integrated dark and light mode toggle.
- Download Standalone ZIP: Instantly bundle the entire generated workspace into a ready-to-run archive.
- Push to GitHub: Direct Personal Access Token / OAuth integration to scaffold a new remote repository with atomic commit history.
MyAppMyWeb executes generated code inside hardened ephemeral environments to prevent Arbitrary Code Execution (ACE) and sandbox escapes:
| Control | Specification | Security Objective |
|---|---|---|
| Network Isolation | --network none |
Prevents unauthorized telemetry, external network access, and reverse shells. |
| User Privileges | UID 1000:1000 (Non-Root) |
Disables root privilege escalation inside the container. |
| Root Filesystem | read-only |
Protects base system libraries and container binaries from unauthorized tampering. |
| Linux Capabilities | --cap-drop=ALL |
Drops all raw kernel, socket, and mounting capabilities. |
| Resource Limits | 512MB RAM, 1.0 CPU, 64 PIDs |
Prevents fork bombs and Host Out-of-Memory (OOM) resource starvation. |
| Execution Watchdog | 30s Strict Timeout |
Terminates blocking or infinite loops automatically. |
Detailed documentation:
SECURITY.md•security/threat-model.md•security/sandbox-policy.md
flowchart TD
subgraph UI["Frontend: Next.js 15 Command Center"]
PromptBox["Autonomous SWE Prompt Engine"]
AgentDAG["Multi-Agent State Graph Visualizer"]
TaskBoard["Task DAG Checklist (9 Stages)"]
FileTree["Hierarchical Explorer & Syntax Viewer"]
DiffView["Self-Healing Before/After Diff Viewer"]
LivePreview["Interactive App Preview Sandbox"]
Terminal["Live Docker ANSI Log Stream (SSE)"]
end
subgraph API["Backend: FastAPI (Python 3.11)"]
SSEStream["POST /api/v1/agent/run/stream"]
ExportAPI["GET /api/v1/agent/export-zip"]
GitHubAPI["POST /api/v1/agent/push-github"]
HealthAPI["GET /health"]
end
subgraph Orchestration["Agent Execution Engine (LangGraph)"]
Manager["👑 Manager Agent"]
Developer["💻 Developer Agent"]
Tester["🧪 Tester Agent"]
Reviewer["🛡️ Reviewer Agent"]
DocAgent["📝 Documentation Agent"]
end
subgraph Sandboxing["Execution Safety"]
DockerRunner["Docker Ephemeral Sandbox / Subprocess"]
VirtualFS["In-Memory Virtual AST Filesystem"]
end
PromptBox --> SSEStream --> Manager --> Developer --> VirtualFS --> DockerRunner --> Tester
Tester -. Failing Trace .-> Developer
Tester -- 100% Passed --> Reviewer --> DocAgent
VirtualFS --> ExportAPI & GitHubAPI
DockerRunner -. ANSI Stream .-> Terminal
- Python 3.10+
- Node.js 18+ & npm
- (Optional) Docker Desktop (for containerized execution)
cd backend
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
python -m uvicorn app.main:app --port 8000 --reloadcd frontend
npm install
npm run devOpen http://localhost:3000 in your browser!
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/v1/agent/run/stream |
Stream real-time agent execution events, DAG progress, and Docker logs via SSE |
GET |
/api/v1/agent/export-zip |
Download the generated project files as a compressed ZIP archive |
POST |
/api/v1/agent/push-github |
Export the generated codebase directly to a remote GitHub repository |
GET |
/health |
Service health check and uptime status |
MyAppMyWeb/
├── .github/
│ ├── workflows/
│ │ ├── ci.yml # CI Test & Verification Pipeline
│ │ └── security-scan.yml # CodeQL & Security Scanner
│ └── dependabot.yml # Automated Dependency Management
├── docs/
│ └── images/ # High-Resolution UI Screenshots
│ ├── dashboard-overview.png
│ ├── docker-stream-self-healing.png
│ ├── live-app-preview.png
│ └── github-export-modal.png
├── backend/
│ ├── app/
│ │ ├── agents/ # Multi-Agent Definitions
│ │ │ ├── manager.py # Spec & Task Decomposition
│ │ │ ├── developer.py # Code Generation & Self-Healing
│ │ │ ├── tester.py # Test Harness Runner
│ │ │ ├── reviewer.py # Static Code & AST Security Audit
│ │ │ └── documentation.py # Markdown & OpenAPI Generator
│ │ ├── api/ # FastAPI REST & SSE Endpoints
│ │ ├── graph/ # LangGraph StateGraph Engine
│ │ ├── sandbox/ # Docker & Virtual FS Sandboxing
│ │ └── main.py # Application Entrypoint
│ ├── Dockerfile
│ └── requirements.txt
├── frontend/
│ ├── src/
│ │ ├── app/ # Next.js 15 App Router
│ │ └── components/ # Command Center UI Components
│ │ ├── Header.tsx # Telemetry & Status Bar
│ │ ├── AgentDAGVisualizer.tsx
│ │ ├── TaskBoard.tsx # 9-Stage Task Execution Checklist
│ │ ├── CodeEditorView.tsx# Explorer & Code Viewer
│ │ ├── DiffViewer.tsx # Self-Healing Git Diff Comparison
│ │ ├── LiveAppPreview.tsx# Interactive App Simulator
│ │ ├── ScorecardReview.tsx # Security & Quality Scorecard
│ │ ├── TerminalLogStream.tsx
│ │ └── GitHubModal.tsx # Direct Push Dialog
│ ├── Dockerfile
│ └── package.json
├── security/
│ ├── threat-model.md # STRIDE & OWASP Mitigation Matrix
│ └── sandbox-policy.md # Hardening & Security Standards
├── docker-compose.yml
├── SECURITY.md
├── CONTRIBUTING.md
├── LICENSE
└── README.md
Developed with ❤️ by Ishant6565.
- GitHub Profile: @Ishant6565
- Repository: https://github.com/Ishant6565/GenAI-Software-Developer-Agent
This project is licensed under the MIT License — see the LICENSE file for details.