first commit

Author: anhnh2002

.DS_Store

@@ -0,0 +1,80 @@
+# Git
+.git
+.gitignore
+
+# Docker
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# Environment files
+.env
+.env.*
+!env.example
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.ven
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Output directories (will be mounted as volumes)
+output/
+trajectories/
+
+# Test data
+data/raw_test_repo/
+data/raw_test_repo_simple/
+
+# Documentation build
+docs/_build/
+docs/.doctrees/
+
+# Cache
+.cache/
+.pytest_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Temporary files
+*.tmp
+*.temp
+.tmp/
+.temp/

.dockerignore

@@ -0,0 +1,15 @@
+config/agent_config.yaml
+tool/add_header.sh
+
+.venv
+__pycache__/
+*.egg-info
+*.ipynb
+output/
+data/
+src/output/
+repo_data/
+.env*
+*.env
+**/.env
+**/.env.*

.gitignore

@@ -0,0 +1,30 @@
+# DeepwikiAgent Docker Setup
+
+This document explains how to run DeepwikiAgent using Docker and Docker Compose.
+
+## Quick Start
+
+1. **Clone the repository** (if not already done):
+   ```bash
+   git clone <repository-url>
+   cd DeepwikiAgent
+   ```
+
+2. **Set up environment variables**:
+   ```bash
+   cp env.example .env
+   # Edit .env file with your API keys
+   ```
+
+3. **Create network**
+   ```bash
+   docker network create deepwiki-agent-network
+   ```
+
+3. **Start the services**:
+   ```bash
+   docker-compose up -d
+   ```
+
+4. **Access the application**:
+   - Main web app: http://localhost:8000

DOCKER_README.md

@@ -0,0 +1,37 @@
+# Use Python 3.11 slim image as base
+FROM python:3.12-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    git \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Create output directories
+RUN mkdir -p output/cache output/temp output/docs output/dependency_graphs
+
+# Set environment variables
+ENV PYTHONPATH=/app/src
+ENV PYTHONUNBUFFERED=1
+
+# Expose port
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/ || exit 1
+
+# Default command
+CMD ["python", "run_web_app.py", "--host", "0.0.0.0", "--port", "8000"]

Dockerfile

@@ -0,0 +1,102 @@
+```bash
+python3.12 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+python run_web_app.py
+```
+
+Check networking for Mermaid validator
+```python
+import mermaid as md
+
+error_mermaid = """
+graph TB
+    subgraph "Core Agent System"
+        A[DefaultAgent] --> B[Agent Execution]
+        B --> C[Step Processing]
+        C --> D[Action Execution]
+    end
+    
+    subgraph "Hook System"
+        E[CombinedAgentHook] --> F[Hook 1]
+        E --> G[Hook 2]
+        E --> H[Hook N]
+    end
+    
+    subgraph "Event Flow"
+        I[on_init] --> J[on_run_start]
+        J --> K[on_step_start]
+        K --> L[on_actions_generated]
+        L --> M[on_action_started]
+        M --> N[on_action_executed]
+        N --> O[on_step_done]
+        O --> P{More Steps?}
+        P -->|Yes| K
+        P -->|No| Q[on_run_done]
+    end
+    
+    A -.-> E : uses hooks
+    B -.-> I
+    C -.-> K
+    D -.-> M
+    
+    style E fill:#e1f5fe
+    style A fill:#f3e5f5
+"""
+
+true_mermaid = """
+graph TB
+    subgraph "CLI Configuration Module"
+        A[Main CLI Entry Point<br/>sweagent.run.run.main] --> B[Command Router]
+        C[BasicCLI Configuration System<br/>sweagent.run.common.BasicCLI] --> D[Config Validation]
+        
+        B --> E[Execution Commands]
+        B --> F[Analysis Commands]
+        B --> G[Inspector Commands]
+        
+        E --> H[Single Execution<br/>run]
+        E --> I[Batch Execution<br/>run-batch]
+        E --> J[Replay Execution<br/>run-replay]
+        E --> K[Shell Execution<br/>shell]
+        
+        F --> L[Merge Predictions<br/>merge-preds]
+        F --> M[Extract Predictions<br/>extract-pred]
+        F --> N[Compare Runs<br/>compare-runs]
+        F --> O[Quick Stats<br/>quick-stats]
+        F --> P[Remove Unfinished<br/>remove-unfinished]
+        
+        G --> Q[Terminal Inspector<br/>inspect]
+        G --> R[Web Inspector<br/>inspector]
+    end
+    
+    subgraph "External Dependencies"
+        S[execution_engines.md]
+        T[inspector_tools.md]
+        U[analysis_utilities.md]
+    end
+    
+    H --> S
+    I --> S
+    J --> S
+    K --> S
+    Q --> T
+    R --> T
+    L --> U
+    M --> U
+    N --> U
+    O --> U
+    P --> U
+    
+    style A fill:#e1f5fe
+    style C fill:#e8f5e8
+    style B fill:#fff3e0
+"""
+
+render = md.Mermaid(error_mermaid)
+print(render.svg_response.text[:50])
+# => Parse error on line 26:\n...  end    A -.-> E : use
+
+render = md.Mermaid(true_mermaid)
+print(render.svg_response.text[:50])
+# => <svg id="mermaid-svg" width="100%" xmlns="http://w
+```

README.md

@@ -0,0 +1,38 @@
+version: '3.8'
+
+services:
+
+  # DeepwikiAgent Web Application
+  deepwiki-agent:
+    image: deepwiki-agent:0.0.1
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: deepwiki-agent
+    ports:
+      - "${APP_PORT:-8000}:8000"
+    environment:
+      - PYTHONPATH=/app/src
+      - PYTHONUNBUFFERED=1
+    env_file:
+      - .env
+    networks:
+      - net
+    volumes:
+      # Persistent storage for cache and output
+      - ./output:/app/output
+      # Git credentials (if needed for private repos)
+      - ~/.gitconfig:/root/.gitconfig:ro
+      - ~/.ssh:/root/.ssh:ro
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:8000/"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 20s
+
+networks:
+  net:
+    external: true
+    name: deepwiki-agent-network

docker-compose.yml

@@ -0,0 +1,20 @@
+# DeepwikiAgent Environment Configuration
+# Copy this file to .env and fill in your API keys
+
+# =============================================================================
+# LLM API Keys
+# =============================================================================
+
+MAIN_MODEL = claude-sonnet-4
+FALLBACK_MODEL_1 = glm-4p5
+LLM_BASE_URL = http://litellm:4000/
+LLM_API_KEY = sk-1234
+
+
+# =============================================================================
+# Application Configuration
+# =============================================================================
+
+# Port for the main web application
+APP_PORT=8000
+