Litho (deepwiki-rs)

English | 中文

💪🏻 High-performance AI-driven intelligent document generator (DeepWiki-like) built with Rust

📚 Automatically generates high quality Repo-Wiki for any codebase

👋 What's Litho

Litho is an AI-powered documentation generation engine that automatically analyzes your source code and generates comprehensive, professional architecture documentation in the C4 model format. No more manual documentation that falls behind code changes - Litho keeps your documentation perfectly in sync with your codebase.

Litho transforms raw code into beautifully structured documentation with context diagrams, container diagrams, component diagrams, and code-level documentation - all automatically generated from your source code.

Whether you're a developer, architect, or technical lead, Litho eliminates the burden of maintaining documentation and ensures your team always has accurate, up-to-date architectural information.

Transform your codebase into professional architecture documentation in minutes

🚀 Litho automatically transforms your messy codebase into beautiful, professional documentation

😺 Why use Litho

• Automatically keep documentation in sync with codebase changes - no more outdated docs
• Save hundreds of hours on manual documentation creation and maintenance
• Improve onboarding for new team members with comprehensive, up-to-date documentation
• Enhance code reviews by providing clear architectural context
• Meet compliance requirements with auditable, automated documentation
• Support for multiple programming languages (Rust, Python, Java, Go, C#, JavaScript, etc.)
• Generate professional C4 model diagrams with context, containers, components, and code
• Integrate with CI/CD pipelines to automatically generate documentation on every commit

🌟 For:

• Development teams of all sizes
• Open source projects
• Enterprise software developers
• Anyone who hates maintaining outdated docs!

❤️ Like Litho? Star it 🌟 or Sponsor Me! ❤️

Thanks to the kind people

🌠 Features & Capabilities

Core Capabilities

• AI-driven architecture documentation generation from codebase analysis
• Automatic C4 model diagram creation (Context, Container, Component, Code)
• Intelligent extraction of code comments, structures, and relationships
• Multi-language support for various programming languages
• Customizable template system for documentation output

Advanced Features

• External Knowledge Integration - Mount external documentation (PDF, Markdown, SQL, etc.) as knowledge sources for enhanced analysis
• Database Documentation - Auto-generate database schema documentation with ERD diagrams for SQL projects
• Git history analysis for tracking architectural evolution
• Cross-referencing between code elements and documentation
• Interactive documentation with embedded diagrams and examples
• Integration with CI/CD pipelines for automated documentation generation

💡 Problem Solved

Litho solves the common problem of outdated and incomplete technical documentation by automatically generating up-to-date architecture documentation from your source code. No more manual documentation that falls behind code changes - Litho keeps your documentation in sync with your codebase.

🌐 Litho Eco Ecosystem

Litho is part of a broader ecosystem of tools designed to enhance developer productivity and documentation quality. The Litho Eco ecosystem includes complementary tools that work seamlessly with Litho to provide a complete documentation workflow:

📘 Litho Book

Litho Book is a high-performance markdown reader built with Rust and Axum, specifically designed to provide an elegant interface for browsing documentation generated by Litho.

Key Features

• Real-time markdown rendering with syntax highlighting
• Full Mermaid chart support for architectural diagrams
• Intelligent search with fuzzy matching for files and content
• High-performance architecture with low memory usage
• AI Intelligent Document Interpretation, Answering Questions

🌠 Snapshots

Integration with Litho

Litho Book serves as the ideal companion application for consuming documentation generated by Litho. The typical workflow is:

1. Use Litho to generate documentation from your codebase
2. Use Litho Book to browse and explore the generated documentation with an elegant interface

Learn more about Litho Book

🔧 Mermaid Fixer

Mermaid Fixer is a high-performance AI-driven tool that automatically detects and fixes syntax errors in Mermaid diagrams within Markdown files.

Key Features

• Automated scanning of directories for Markdown files
• Precise detection of Mermaid syntax errors using JS sandbox validation
• AI-powered intelligent fixing with LLM integration
• Comprehensive reporting of before/after changes
• Flexible configuration with support for multiple LLM providers

Integration with Litho

Mermaid Fixer enhances the quality of documentation generated by Litho by automatically fixing syntax errors in Mermaid diagrams. This ensures that all architectural diagrams in your documentation are valid and render correctly.

👀 Snapshots

Learn more about Mermaid Fixer

🤖Agent Skills

Run in Smithery!

🧠 How it works

Four-Stage Processing Pipeline

Litho's architecture is designed around a four-stage processing pipeline that transforms raw code into comprehensive documentation:

flowchart TD
    A[Input: Source Code Repository] --> B[Phase 1: Preprocessing]
    B --> C[Phase 2: Intelligent Research & Analysis]
    C --> D[Phase 3: Documentation Generation]
    D --> E[Phase 4: Verification & Enhancement]
    E --> F[Output: High-Quality Technical Documentation]

    subgraph Preprocessing Phase
        B1[Code Scanning & Discovery]
        B2[Multi-Language Syntax Analysis]
        B3[Structure & Dependency Extraction]
        B4[Code Insight Generation]
        B5[Agent Memory Chunk Initialization]
        B --> B1 --> B2 --> B3 --> B4 --> B5
    end

    subgraph Intelligent Research & Analysis Phase
        C1[System Context Researcher]
        C2[Domain Module Detector]
        C3[Workflow Researcher]
        C4[Boundary Analyzer]
        C5[Key Module Insight Officer]
        C6[Agent Memory Chunk Read/Write]
        C7[ReAct Reasoning Loop]
        C --> C1 --> C2 --> C3 --> C4 --> C5 --> C6 --> C7
    end

    subgraph Documentation Generation Phase
        D1[Overview Documentation Editor]
        D2[Architecture Documentation Editor]
        D3[Workflow Documentation Editor]
        D4[Boundary Documentation Editor]
        D5[Key Module Editor]
        D6[Agent Memory Chunk Reading]
        D7[High-Quality Documentation Assembly]
        D --> D1 --> D2 --> D3 --> D4 --> D5 --> D6 --> D7
    end

    subgraph Verification & Enhancement Phase
        E1[Mermaid Syntax Verification]
        E2[Documentation Integrity Check]
        E3[Diagram Auto-Repair]
        E4[Quality Report Generation]
        E5[Final Documentation Output]
        E --> E1 --> E2 --> E3 --> E4 --> E5
    end

    style B fill:#e3f2fd,stroke:#1976d2
    style C fill:#f3e5f5,stroke:#7b1fa2
    style D fill:#e8f5e8,stroke:#388e3c
    style E fill:#fff3e0,stroke:#e65100

Preprocessing Stage

Litho begins by scanning your entire codebase to identify source files, extract metadata, and analyze project structure. This stage:

• Discovers all source code files across multiple languages
• Parses file structures and identifies key components
• Extracts comments, documentation strings, and code annotations
• Identifies dependencies between modules and components
• Builds a comprehensive representation of your codebase

flowchart TD
A[Preprocessing Agent] --> B[Structure Extractor]
A --> C[Original Document Extractor]
A --> D[Code Analysis Agent]
A --> E[Relationship Analysis Agent]
B --> F[Project Structure]
C --> G[Original Document Materials]
D --> H[Core Code Insights]
E --> I[Code Dependencies]
F --> J[Store to Memory]
G --> J
H --> J
I --> J

Research Stage

In this AI-powered stage, Litho analyzes the code structure to understand the architectural intent:

• Applies machine learning models to identify patterns and relationships
• Infers architectural roles from code structure and naming conventions
• Determines component boundaries and service responsibilities
• Maps dependencies and data flow between components
• Identifies potential architectural smells and anti-patterns
• Generates context-aware documentation for each component

flowchart TD
A[Research Orchestrator] --> B[SystemContext Researcher]
A --> C[Domain Module Detector]
A --> D[Architecture Researcher]
A --> E[Workflow Researcher]
A --> F[Key Module Insights]
B --> G[System Context Report]
C --> H[Domain Module Report]
D --> I[Architecture Analysis Report]
E --> J[Workflow Analysis Report]
F --> K[Module Deep Insights]
G --> Memory
H --> Memory
I --> Memory
J --> Memory
K --> Memory

Composition and Output Stage

Litho combines the analyzed information into a structured documentation format:

• Gene