Fluen is a modern, LLM-powered documentation generator that understands your code. Point it at any git repository, and it will create comprehensive, intelligent documentation that captures not just the structure, but the intent and relationships within your codebase.
- Language Agnostic: Works with any programming language - understands patterns, idioms, and best practices across different languages
- Intelligent Analysis: Uses LLMs to understand code purpose, relationships, and architectural patterns
- Git Integration: Works with any git repository, tracks changes, and updates documentation incrementally
- Rich Documentation: Generates both HTML and Markdown documentation with:
- Cross-referenced code elements
- Dependency graphs
- Public API documentation
- Code purpose analysis
- Framework detection
- Install Fluen:
pip install fluen- Create a configuration file:
# Copy the example config
cp fluen_config.example.yml fluen_config.yml
# Edit the config file with your LLM provider settings
vim fluen_config.yml- Generate documentation: The generate command analyzes the project and generates a code manifest.json file. We recommend you to first clone a repository and then run fluen from the root of your local repository.
# For local repository
fluen docs generate
# For remote repository
fluen docs generate --repo https://github.com/username/repo.gitOnce the manifest.json generation succeeds, run the export command to export in html or markdown format
# Default export type configured in fluen_config.yml
fluen docs export
# Explicitly tell the export format type html/md
fluen docs export --type md- View your documentation:
# Documentation will be available in ./docs directory
open docs/html/index.html- Update your documentation
Fluen is designed to update documentation incrementally with git commits. However there might be scenarios where you need to fore an update. Simply use the
--forceflag
fluen docs generate --force- Selective scanning (of sub directories)
In case you want Fluen to look at only a specific sub-directory, then use the
--scanflag
fluen docs generate --scan path:<your_sub_path>You may use the --force flag to force updates
Help new team members understand your codebase quickly with AI-generated documentation that explains not just what the code does, but why it does it.
Get a comprehensive view of your project's architecture, dependencies, and exposed APIs. Perfect for security audits and architectural reviews.
Generate and maintain up-to-date technical documentation without manual effort. Fluen tracks changes and updates only what's needed.
Make sense of legacy codebases by letting Fluen analyze patterns, dependencies, and architectural decisions embedded in the code.
Fluen uses a YAML configuration file (fluen_config.yml) for customization. Here's a minimal configuration:
llm:
# Choose your provider: 'openai' or 'mistral' or 'ollama' for local use
provider: openai
api_key: your-api-key-here
model: gpt-3.5-turbo # or 'gpt-4o' for better results
# Output directory for generated documentation
output_dir: docs
# Documentation format
default_export_type: html # or 'md' for markdownSee fluen_config.example.yml for a complete configuration example with all available options.
- Python 3.9 or higher
- Git
- An API key from OpenAI or Mistral AI (recommended providers)
Exciting features coming soon:
- Interactive code chat interface with project-wide search
- Enhanced code element descriptions and relationships
- PDF export
- Custom template support
- Plugin system
- CI/CD integration
We welcome contributions! Whether it's bug reports, feature requests, or code contributions, please feel free to contribute.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Install development dependencies:
pip install -e ".[dev]"- Make your changes
- Run tests:
pytest- Submit a Pull Request
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Give a ⭐️ if this project helped you!
Made with ❤️ by Fluen using the Jiva Framework and Claude by Anthropic