Clean up project: add LICENSE, simplify Modal config, update docs

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aghil Sabu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -1,4 +1,4 @@
-.PHONY: install run dev clean deploy help
+.PHONY: install run dev clean modal-deploy modal-install modal-login help
 
 # Python configuration
 PYTHON = python3
@@ -42,9 +42,19 @@ dev: ## Run with auto-reload
 	@echo "🔧 Starting in dev mode..."
 	@GRADIO_WATCH_DIRS=. $(VENV_PYTHON) app.py
 
-deploy: ## Deploy backend to Modal
+modal-login: ## Authenticate with Modal (run once)
+	@echo "🔐 Authenticating with Modal..."
+	@$(VENV)/bin/modal token new
+	@echo "✅ Modal authenticated!"
+
+modal-install: ## Install Modal CLI in venv
+	@echo "📦 Installing Modal..."
+	@$(VENV_PIP) install modal
+	@echo "✅ Modal installed! Run 'make modal-login' to authenticate"
+
+modal-deploy: ## Deploy backend API to Modal
 	@echo "☁️  Deploying to Modal..."
-	@modal deploy modal_backend.py
+	@$(VENV)/bin/modal deploy modal_backend.py
 	@echo "✅ Deployed!"
 
 clean: ## Remove venv and cache files

README.md

@@ -23,6 +23,7 @@ tags:
   - graphviz
   - architecture
   - visualization
+  - mcp-server
 ---
 
 <div align="center">
@@ -34,7 +35,7 @@ tags:
 **Transform any GitHub repository into beautiful architecture diagrams with voice narration and AI chat — powered by MCP**
 
 [![Live Demo](https://img.shields.io/badge/🚀_Live_Demo-HuggingFace-yellow)](https://huggingface.co/spaces/MCP-1st-Birthday/CodeAtlas)
-[![Gradio 6](https://img.shields.io/badge/Built%20with-Gradio%206-FF7C00)](https://gradio.app)
+[![Gradio](https://img.shields.io/badge/Built%20with-Gradio-FF7C00)](https://gradio.app)
 [![MCP](https://img.shields.io/badge/MCP-Server%20Enabled-8B5CF6)](https://modelcontextprotocol.io)
 [![LlamaIndex](https://img.shields.io/badge/🦙_LlamaIndex-Integrated-blue)](https://llamaindex.ai)
 [![Gemini](https://img.shields.io/badge/✨_Gemini_3.0-Powered-4285F4)](https://ai.google.dev)
@@ -42,7 +43,7 @@ tags:
 [![ElevenLabs](https://img.shields.io/badge/🎙️_ElevenLabs-Voice-000000)](https://elevenlabs.io)
 [![Modal](https://img.shields.io/badge/☁️_Modal-Deployed-00D4AA)](https://modal.com)
 
-**[📺 Demo Video](#-demo-video)** • **[🔗 Try it Live](https://huggingface.co/spaces/MCP-1st-Birthday/CodeAtlas)** • **[📱 Social Post](https://x.com/your-post-link)**
+**[🔗 Try it Live](https://huggingface.co/spaces/MCP-1st-Birthday/CodeAtlas)** • **[📺 Demo Video](#-demo-video)** • **[📱 Social Post](https://x.com/your-post-link)**
 
 </div>
 
@@ -50,9 +51,10 @@ tags:
 
 ## 🎬 Demo Video
 
+<!-- Replace with your actual video link -->
 https://github.com/user-attachments/assets/YOUR_VIDEO_ID
 
-> *Watch CodeAtlas analyze the Flask repository in real-time, generate architecture diagrams, and explain the codebase with voice narration.*
+> *Watch CodeAtlas analyze a GitHub repository in real-time, generate architecture diagrams, and explain the codebase with voice narration.*
 
 ---
 
@@ -117,7 +119,7 @@ https://github.com/user-attachments/assets/YOUR_VIDEO_ID
 | 🗺️ **Architecture Diagrams** | AI-generated Graphviz diagrams with layers, clusters, and relationships | **Graphviz** + Gemini AI |
 | 🔊 **Voice Narration** | Natural speech explanation of your architecture | **🎙️ ElevenLabs TTS** |
 | 💬 **AI Chat** | Context-aware Q&A about your codebase | **🦙 LlamaIndex** RAG |
-| 🤖 **Multi-Model Support** | Choose between Gemini 3.0 Pro, 2.5 Pro/Flash, or GPT-5.1/5 Mini | **Google Gemini** + **OpenAI** |
+| 🤖 **Multi-Model Support** | Choose between Gemini 3.0/2.5 Pro/Flash or GPT-5.1/5 Mini | **Google Gemini** + **OpenAI** |
 | 📐 **Interactive Layout** | Real-time diagram adjustments (direction, spacing, zoom) | Graphviz DOT |
 | 📜 **Diagram History** | Browse and reload previous analyses | Local Storage |
 | 🔌 **MCP Server** | 4 tools for AI agent integration | **FastMCP** |
@@ -127,87 +129,66 @@ https://github.com/user-attachments/assets/YOUR_VIDEO_ID
 
 ## 🔌 MCP Server Integration
 
-CodeAtlas is a **native MCP server** — connect it to Claude Desktop, Cursor, or any MCP client to analyze codebases directly from your AI assistant!
-
-### Available MCP Tools
+CodeAtlas exposes **4 MCP tools** for AI agent integration:
 
 | Tool | Description |
 |------|-------------|
-| `analyze_codebase` | Generate architecture diagram from GitHub URL or file path |
-| `get_architecture_summary` | Get detailed text summary of codebase architecture |
+| `analyze_codebase` | Generate architecture diagram from GitHub URL |
+| `get_architecture_summary` | Get text summary of codebase architecture |
 | `chat_with_codebase` | Ask questions about any codebase |
 | `list_recent_analyses` | List recently analyzed repositories |
 
-### Connect to Claude Desktop
-
-Add this to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "codeatlas": {
-      "url": "https://your-deployment.modal.run/gradio_api/mcp/sse"
-    }
-  }
-}
-```
-
-Then ask Claude: *"Analyze the architecture of github.com/pallets/flask using CodeAtlas"*
+**MCP Endpoint:** `https://huggingface.co/spaces/MCP-1st-Birthday/CodeAtlas/gradio_api/mcp/sse`
 
 ---
 
-## 🛠️ Tech Stack & Library Integrations
+## 🛠️ Tech Stack
+
+CodeAtlas integrates multiple technologies for a comprehensive solution:
 
-CodeAtlas integrates **6 major sponsor technologies** for a comprehensive solution:
+| Layer | Technology | Purpose |
+|-------|------------|---------|
+| **🎨 UI Framework** | [**Gradio 6**](https://gradio.app) | Multi-page routing, `mcp_server=True` |
+| **🦙 AI Framework** | [**LlamaIndex**](https://llamaindex.ai) | Unified LLM interface, RAG |
+| **✨ Primary AI** | [**Google Gemini**](https://ai.google.dev) | Gemini 3.0 Pro, 2.5 Pro/Flash |
+| **🤖 Alternate AI** | [**OpenAI**](https://openai.com) | GPT-5.1, GPT-5 Mini/Nano |
+| **🎙️ Voice TTS** | [**ElevenLabs**](https://elevenlabs.io) | High-quality voice narration |
+| **☁️ Backend API** | [**Modal**](https://modal.com) | Serverless API endpoints |
+| **🔌 MCP Protocol** | [**FastMCP**](https://github.com/jlowin/fastmcp) | Model Context Protocol |
 
-| Layer | Technology | Prize Category |
-|-------|------------|----------------|
-| **🎨 UI Framework** | [**Gradio 6**](https://gradio.app) — Multi-page routing, `mcp_server=True` | Core Hackathon |
-| **🦙 AI Framework** | [**LlamaIndex**](https://llamaindex.ai) — Unified LLM interface, RAG | **$1K LlamaIndex Prize** |
-| **✨ Primary AI** | [**Google Gemini**](https://ai.google.dev) — Gemini 3.0 Pro, 2.5 Pro/Flash | **$10K Gemini Credits** |
-| **🤖 Alternate AI** | [**OpenAI**](https://openai.com) — GPT-5.1, GPT-5 Mini/Nano | **ChatGPT Pro + $1K Credits** |
-| **🎙️ Voice TTS** | [**ElevenLabs**](https://elevenlabs.io) — High-quality voice narration | **~$2K + AirPods Pro** |
-| **☁️ Deployment** | [**Modal**](https://modal.com) — Serverless cloud, auto-scaling | **$2.5K Modal Prize** |
-| **🔌 MCP Protocol** | [**FastMCP**](https://github.com/jlowin/fastmcp) — Model Context Protocol | Core MCP Track |
+---
 
-### Integration Architecture
+## 📁 Project Structure
 
 ```
-┌──────────────────────────────────────────────────────────────────────────────────┐
-│                              🏗️ CodeAtlas Architecture                           │
-├──────────────────────────────────────────────────────────────────────────────────┤
-│                                                                                  │
-│  ┌─────────────────────────────────────────────────────────────────────────────┐ │
-│  │                           USER INTERFACE LAYER                              │ │
-│  │  ┌──────────────┐   ┌──────────────┐   ┌──────────────┐                    │ │
-│  │  │   Gradio 6   │   │  MCP Server  │   │   FastAPI    │                    │ │
-│  │  │  (Multi-page)│   │  (4 Tools)   │   │  (Health)    │                    │ │
-│  │  └──────┬───────┘   └──────┬───────┘   └──────────────┘                    │ │
-│  └─────────┼──────────────────┼───────────────────────────────────────────────┘ │
-│            │                  │                                                  │
-│            ▼                  ▼                                                  │
-│  ┌─────────────────────────────────────────────────────────────────────────────┐ │
-│  │                           AI PROCESSING LAYER                               │ │
-│  │  ┌──────────────┐   ┌──────────────┐   ┌──────────────┐                    │ │
-│  │  │  🦙 LlamaIndex│──▶│ Gemini 3.0   │   │   GPT-5.1    │                    │ │
-│  │  │  (Unified AI) │   │ Pro/2.5 Flash│   │   Mini/Nano  │                    │ │
-│  │  └──────┬───────┘   └──────────────┘   └──────────────┘                    │ │
-│  └─────────┼────────────────────────────────────────────────────────────────────┘ │
-│            │                                                                      │
-│            ▼                                                                      │
-│  ┌─────────────────────────────────────────────────────────────────────────────┐ │
-│  │                           OUTPUT & SERVICES LAYER                           │ │
-│  │  ┌──────────────┐   ┌──────────────┐   ┌──────────────┐                    │ │
-│  │  │  Graphviz    │   │ 🎙️ ElevenLabs│   │   GitHub     │                    │ │
-│  │  │  (Diagrams)  │   │   (Voice)    │   │   (Loader)   │                    │ │
-│  │  └──────────────┘   └──────────────┘   └──────────────┘                    │ │
-│  └─────────────────────────────────────────────────────────────────────────────┘ │
-│                                                                                  │
-│  ┌─────────────────────────────────────────────────────────────────────────────┐ │
-│  │                           DEPLOYMENT LAYER                                  │ │
-│  │                    ☁️ Modal (Serverless, Auto-scaling)                      │ │
-│  └─────────────────────────────────────────────────────────────────────────────┘ │
-└──────────────────────────────────────────────────────────────────────────────────┘
+codeAtlas/
+├── app.py                  # Main Gradio application entry point
+├── modal_backend.py        # Modal serverless API deployment
+├── requirements.txt        # Python dependencies
+├── Makefile               # Build and run commands
+├── src/
+│   ├── config.py          # Configuration management
+│   ├── core/
+│   │   ├── analyzer.py    # AI-powered codebase analysis
+│   │   ├── diagram.py     # Graphviz diagram generation
+│   │   └── repository.py  # GitHub/ZIP repository loading
+│   ├── integrations/
+│   │   ├── elevenlabs.py  # ElevenLabs TTS integration
+│   │   ├── modal_client.py # Modal API client
+│   │   └── voice.py       # Voice synthesis utilities
+│   ├── mcp/
+│   │   ├── server.py      # FastMCP server setup
+│   │   └── tools.py       # MCP tool definitions
+│   └── ui/
+│       ├── app.py         # UI layout and routing
+│       ├── components.py  # Reusable UI components
+│       └── styles.py      # CSS styling
+├── data/
+│   ├── diagrams/          # Generated diagram files
+│   ├── audios/            # Voice narration files
+│   └── logs/              # Application logs
+└── assets/
+    └── screenshots/       # Documentation screenshots
 ```
 
 ---
@@ -222,8 +203,8 @@ CodeAtlas integrates **6 major sponsor technologies** for a comprehensive soluti
 
 ```bash
 # Clone and setup
-git clone https://github.com/yourusername/CodeAtlas.git
-cd CodeAtlas
+git clone https://github.com/aghilsabu/codeAtlas.git
+cd codeAtlas
 python -m venv .venv && source .venv/bin/activate
 pip install -r requirements.txt
 
@@ -240,31 +221,22 @@ make install  # Create venv and install dependencies
 make run      # Run the application
 ```
 
-### Option 3: Deploy to Hugging Face Spaces + Modal Backend
-
-**For the hackathon submission**, we use:
-- **HF Space**: Runs the Gradio UI (required for hackathon)
-- **Modal Backend**: Provides compute endpoints (eligible for $2.5K Modal prize)
+### Option 3: Deploy API Backend to Modal
 
 ```bash
-# 1. Deploy Modal backend first
-pip install modal && modal setup
+# Deploy the serverless API backend on Modal
 modal deploy modal_backend.py
-# Note your endpoint URLs
-
-# 2. Push to HF Spaces
-# Set MODAL_BACKEND_URL secret in your HF Space settings
-# pointing to your Modal deployment URL
 ```
 
-### Option 4: Deploy Full App to Modal (Standalone)
+**Modal Backend API Endpoints:**
+| Endpoint | URL |
+|----------|-----|
+| Health Check | `https://aghilsabu--codeatlas-backend-health.modal.run` |
+| Generate Diagram | `https://aghilsabu--codeatlas-backend-generate-diagram.modal.run` |
+| Generate Voice | `https://aghilsabu--codeatlas-backend-generate-voice.modal.run` |
+| Analyze Codebase | `https://aghilsabu--codeatlas-backend-analyze-codebase.modal.run` |
 
-```bash
-# Deploy the complete app on Modal
-modal deploy modal_app.py
-```
-
-Your app will be live at `https://your-modal-url.modal.run` 🚀
+These serverless endpoints handle heavy compute operations and can be called from any frontend! 🚀
 
 ---
 
@@ -275,50 +247,11 @@ Configure API keys via the **Settings** page in the UI:
 | Key | Required | Purpose | Get Key |
 |-----|----------|---------|---------|
 | **Gemini API Key** | ✅ Yes | Primary AI engine | [aistudio.google.com/apikey](https://aistudio.google.com/apikey) |
-| **OpenAI API Key** | Optional | GPT-5.1/5 Mini/Nano models | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) |
+| **OpenAI API Key** | Optional | GPT-5.1/5 Mini models | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) |
 | **ElevenLabs API Key** | Optional | Voice narration | [elevenlabs.io/app/developers](https://elevenlabs.io/app/developers/api-keys) |
 
 ---
 
-## 📁 Project Structure
-
-```
-CodeAtlas/
-├── app.py                  # 🚀 Main entry point
-├── modal_app.py            # ☁️ Modal cloud deployment
-├── server.py               # 🔌 MCP server entry
-├── requirements.txt        # 📦 Dependencies
-├── Makefile                # 🛠️ Build commands
-│
-├── src/
-│   ├── config.py           # ⚙️ Configuration & settings
-│   │
-│   ├── core/               # 🧠 Core analysis engine
-│   │   ├── analyzer.py     # LlamaIndex + Gemini/OpenAI
-│   │   ├── diagram.py      # Graphviz rendering
-│   │   └── repository.py   # GitHub/ZIP processing
-│   │
-│   ├── integrations/       # 🔗 External services
-│   │   ├── elevenlabs.py   # ElevenLabs TTS client
-│   │   └── voice.py        # Audio generation pipeline
-│   │
-│   ├── mcp/                # 🤖 MCP Protocol
-│   │   ├── server.py       # FastMCP server
-│   │   └── tools.py        # 4 MCP tools
-│   │
-│   └── ui/                 # 🎨 Gradio interface
-│       ├── app.py          # Multi-page routes
-│       ├── components.py   # Reusable UI components
-│       └── styles.py       # Custom CSS
-│
-└── data/
-    ├── diagrams/           # 📊 Generated DOT files
-    ├── audios/             # 🔊 Generated audio files
-    └── logs/               # 📝 Application logs
-```
-
----
-
 ## 🔍 How It Works
 
 ```mermaid
@@ -338,7 +271,7 @@ flowchart LR
 ```
 
 1. **📥 Load Repository** — Download from GitHub or extract ZIP, smart-filter to relevant code files (excludes node_modules, tests, configs)
-2. **🧠 AI Analysis** — LlamaIndex processes code context with Gemini 3.0 Pro (or GPT-5.1) to understand architecture
+2. **🧠 AI Analysis** — LlamaIndex processes code context with Gemini 3.0 (or GPT-5.1) to understand architecture
 3. **🗺️ Generate Diagram** — AI creates Graphviz DOT code with 15-20 key nodes showing layers, clusters, and relationships
 4. **🔊 Voice Narration** — AI generates natural summary, ElevenLabs converts to high-quality speech
 5. **💬 Chat Interface** — Context-aware Q&A about the analyzed codebase with conversation history
@@ -347,44 +280,20 @@ flowchart LR
 
 ## 🎯 Use Cases
 
-| Scenario | How CodeAtlas Helps |
-|----------|---------------------|
-| **🆕 Onboarding** | New team members instantly understand codebase structure |
-| **📝 Documentation** | Generate architecture diagrams for README/docs |
-| **🔍 Code Review** | Visualize PR changes in context of overall architecture |
-| **📚 Learning** | Understand how popular open-source projects are structured |
-| **🏚️ Legacy Code** | Make sense of undocumented older codebases |
-| **🤖 AI Agents** | Give Claude/Cursor AI ability to analyze any repo via MCP |
-
----
-
-## 🏆 Hackathon Submission
-
-This project is submitted to **MCP's 1st Birthday Hackathon** hosted by Anthropic and Gradio.
-
-- **Track:** MCP in Action → Consumer
-- **Tags:** `mcp-in-action-track-consumer`
-- **Team:** Solo
-
-### Sponsor Integrations
-
-| Sponsor | Integration | Feature |
-|---------|-------------|---------|
-| 🦙 **LlamaIndex** | `llama-index-core`, `llama-index-llms-gemini`, `llama-index-llms-openai` | Unified AI interface, RAG support |
-| ✨ **Google Gemini** | `google-genai`, Gemini 3.0 Pro, 2.5 Pro/Flash | Primary AI analysis engine |
-| 🤖 **OpenAI** | `openai`, GPT-5.1, GPT-5 Mini/Nano | Alternative AI model support |
-| 🎙️ **ElevenLabs** | `elevenlabs` | Voice narration TTS |
-| ☁️ **Modal** | `modal` | Serverless cloud deployment |
-| 🔌 **FastMCP** | `fastmcp`, `mcp` | MCP protocol server |
+- **Onboarding** — New team members instantly understand codebase structure
+- **Documentation** — Generate architecture diagrams for README/docs  
+- **Code Review** — Visualize changes in context of overall architecture
+- **Learning** — Understand how popular open-source projects are structured
+- **Legacy Code** — Make sense of undocumented older codebases
 
 ---
 
 ## 👨‍💻 Author
 
-**Your Name**
-- GitHub: [@yourusername](https://github.com/yourusername)
-- HuggingFace: [@yourusername](https://huggingface.co/yourusername)
-- Twitter/X: [@yourhandle](https://x.com/yourhandle)
+**Aghil Sabu**
+- GitHub: [@aghilsabu](https://github.com/aghilsabu)
+- HuggingFace: [@aghilsabu](https://huggingface.co/aghilsabu)
+- Twitter/X: [@AghilSabu](https://x.com/AghilSabu)
 
 ---
 
@@ -400,6 +309,6 @@ MIT License — see [LICENSE](LICENSE) for details.
 
 *November 2025*
 
-[![Star on GitHub](https://img.shields.io/github/stars/yourusername/CodeAtlas?style=social)](https://github.com/yourusername/CodeAtlas)
+[![Star on GitHub](https://img.shields.io/github/stars/aghilsabu/codeAtlas?style=social)](https://github.com/aghilsabu/codeAtlas)
 
 </div>

app.py

@@ -16,34 +16,13 @@ def main():
         neutral_hue=gr.themes.colors.gray,
     )
     
-    # Force light theme CSS
-    light_theme_css = """
-    .dark {
-        --body-background-fill: white !important;
-        --background-fill-primary: white !important;
-        --background-fill-secondary: #f7f7f7 !important;
-        --block-background-fill: white !important;
-        --body-text-color: #374151 !important;
-        --block-label-text-color: #374151 !important;
-        --block-title-text-color: #374151 !important;
-        --input-background-fill: white !important;
-        --input-background-fill-focus: white !important;
-        --border-color-primary: #e5e7eb !important;
-        --link-text-color: #ea580c !important;
-        --link-text-color-hover: #c2410c !important;
-        --button-primary-background-fill: #ea580c !important;
-        --button-primary-text-color: white !important;
-    }
-    """
-    combined_css = light_theme_css + (custom_css or "")
-    
     app.launch(
         share=False,
         server_name="0.0.0.0",
         server_port=7860,
         mcp_server=True,
         theme=theme,
-        css=combined_css,
+        css=custom_css,
         allowed_paths=[str(AUDIOS_DIR)],
     )
 

modal_app.py

@@ -1,98 +0,0 @@
-"""CodeAtlas - Modal Cloud Deployment"""
-
-import modal
-
-app = modal.App(name="codeatlas")
-
-image = (
-    modal.Image.debian_slim(python_version="3.12")
-    .apt_install("graphviz", "fonts-liberation")
-    .pip_install(
-        "gradio>=5.0.0",
-        "fastapi[standard]",
-        "uvicorn>=0.20.0",
-        "google-genai>=1.0.0",
-        "llama-index-core>=0.11.0",
-        "llama-index-llms-gemini>=0.4.0",
-        "llama-index-llms-openai>=0.3.0",
-        "elevenlabs>=1.0.0",
-        "fastmcp>=0.1.0",
-        "requests>=2.31.0",
-        "graphviz>=0.20.0",
-    )
-)
-
-local_files = modal.Mount.from_local_dir(
-    ".",
-    remote_path="/app",
-    condition=lambda path: not any(x in path for x in [
-        "__pycache__", ".git", ".venv", "node_modules",
-        "data/", ".session_state.json", ".env",
-    ])
-)
-
-
-@app.function(
-    image=image,
-    mounts=[local_files],
-    cpu=2.0,
-    memory=4096,
-    min_containers=0,
-    max_containers=10,
-    scaledown_window=300,
-    timeout=600,
-    secrets=[modal.Secret.from_name("codeatlas-secrets", required_keys=[])],
-)
-@modal.concurrent(max_inputs=50)
-@modal.asgi_app()
-def serve():
-    """Serve the CodeAtlas Gradio application."""
-    import os
-    import sys
-    
-    sys.path.insert(0, "/app")
-    os.chdir("/app")
-    
-    os.makedirs("/app/data/diagrams", exist_ok=True)
-    os.makedirs("/app/data/audios", exist_ok=True)
-    os.makedirs("/app/data/logs", exist_ok=True)
-    
-    from fastapi import FastAPI
-    from gradio.routes import mount_gradio_app
-    from src.ui import create_app, CUSTOM_CSS
-    import gradio as gr
-    
-    gradio_app, _ = create_app()
-    
-    theme = gr.themes.Soft(
-        primary_hue=gr.themes.colors.orange,
-        secondary_hue=gr.themes.colors.orange,
-        neutral_hue=gr.themes.colors.gray,
-    )
-    
-    fastapi_app = FastAPI(title="CodeAtlas", version="1.0.0")
-    
-    @fastapi_app.get("/health")
-    async def health():
-        return {"status": "healthy"}
-    
-    return mount_gradio_app(app=fastapi_app, blocks=gradio_app, path="/")
-
-
-@app.function(image=image, mounts=[local_files], cpu=1.0, memory=2048, timeout=300)
-def analyze_codebase_remote(github_url: str, api_key: str, model_name: str = "gemini-2.5-flash") -> str:
-    """Remote function to analyze a codebase."""
-    import sys
-    import os
-    
-    sys.path.insert(0, "/app")
-    os.chdir("/app")
-    
-    from src.mcp.tools import analyze_codebase
-    return analyze_codebase(api_key=api_key, github_url=github_url, model_name=model_name)
-
-
-@app.local_entrypoint()
-def main():
-    print("🚀 Use 'modal serve modal_app.py' to test locally")
-    print("   Use 'modal deploy modal_app.py' to deploy")

modal_backend.py

@@ -14,11 +14,12 @@ import json
 # Create Modal app
 app = modal.App(name="codeatlas-backend")
 
-# Container image with all dependencies
+# Container image with all dependencies and source code
 image = (
     modal.Image.debian_slim(python_version="3.12")
     .apt_install("graphviz", "fonts-liberation", "git")
     .pip_install(
+        "fastapi",
         "google-genai>=1.0.0",
         "llama-index-core>=0.11.0",
         "llama-index-llms-gemini>=0.4.0",
@@ -28,16 +29,8 @@ image = (
         "graphviz>=0.20.0",
         "requests>=2.31.0",
     )
-)
-
-# Mount source code (excluding data and cache)
-local_files = modal.Mount.from_local_dir(
-    ".",
-    remote_path="/app",
-    condition=lambda path: not any(x in path for x in [
-        "__pycache__", ".git", ".venv", "node_modules",
-        "data/", ".session_state.json", ".env",
-    ])
+    .add_local_dir("src", "/app/src", copy=True)
+    .add_local_file("app.py", "/app/app.py", copy=True)
 )
 
 
@@ -47,11 +40,9 @@ local_files = modal.Mount.from_local_dir(
 
 @app.function(
     image=image,
-    mounts=[local_files],
     cpu=2.0,
     memory=4096,
     timeout=300,
-    secrets=[modal.Secret.from_name("codeatlas-secrets", required_keys=[])],
 )
 @modal.web_endpoint(method="POST", docs=True)
 def generate_diagram(request: dict) -> dict:
@@ -137,11 +128,9 @@ def generate_diagram(request: dict) -> dict:
 
 @app.function(
     image=image,
-    mounts=[local_files],
     cpu=1.0,
     memory=2048,
     timeout=120,
-    secrets=[modal.Secret.from_name("codeatlas-secrets", required_keys=[])],
 )
 @modal.web_endpoint(method="POST", docs=True)
 def generate_voice(request: dict) -> dict:
@@ -213,11 +202,9 @@ def generate_voice(request: dict) -> dict:
 
 @app.function(
     image=image,
-    mounts=[local_files],
     cpu=2.0,
     memory=4096,
     timeout=300,
-    secrets=[modal.Secret.from_name("codeatlas-secrets", required_keys=[])],
 )
 @modal.web_endpoint(method="POST", docs=True)
 def analyze_codebase(request: dict) -> dict:

requirements.txt

@@ -34,6 +34,8 @@ graphviz>=0.20.0
 # ==================== Utilities ====================
 requests>=2.31.0
 
+# ==================== Modal Deployment ====================
+modal>=0.64.0
 
 # ==================== Development ====================
 # ruff  # Linting