frumle 0.1.0

AI-powered codebase analyzer and API documentation for Python projects

frumle (Python)

AI-powered codebase analyzer for Python projects. Scan your Flask, FastAPI, Django, or Starlette app and get API documentation in your Frumle dashboard.

What is frumle?

frumle scans your Python codebase, sends it to the Frumle backend, and generates documentation including:

• API Documentation: Endpoints, request/response bodies, parameters, authentication
• Structured Analysis: Overview, architecture, tech stack
• Dashboard: View everything at frumle.tellecata.com

Same backend as the npm and Maven / Gradle plugins—only the CLI and file scanning are Python-specific.

Quick Start

1. Install

pip install frumle

Or run without installing (from a clone):

python -m pip install -e .
# or
PYTHONPATH=src python -m frumle --help

2. Get your API key

1. Go to frumle.tellecata.com
2. Sign up and copy your API key from the dashboard

3. Add your API key

frumle add-key <your-api-key>

Or:

frumle login <your-api-key>

4. Analyze your project

From your project root:

frumle

Or a specific directory:

frumle ./src
frumle ./app

Analysis runs on the server. When it’s done, open your dashboard to see the docs.

Commands

Command	Description
frumle	Analyze current directory (default)
frumle <directory>	Analyze a given directory
frumle add-key <key>	Store and verify your API key
frumle login <key>	Same as add-key
frumle status	Show API key status and quota

Options

• --project-name <name> – Project name (default: directory name or pyproject.toml / setup.py name)
• --ignore <dirs> – Comma-separated dirs to ignore (default: __pycache__,.git,.venv,venv,env,.eggs,dist,build)

Examples

# Use a custom project name
frumle --project-name my-fastapi-app

# Ignore extra directories
frumle --ignore __pycache__,.pytest_cache,.mypy_cache

Supported frameworks

• Flask – @app.route, blueprints
• FastAPI – @app.get, @app.post, routers, APIRouter
• Django – URLconf, DRF views, @api_view
• Starlette – Route, Router
• Other – Any Python web app with route-like patterns

Config file

Running frumle creates or updates frumle.config.json in the project with base URLs, e.g.:

{
  "baseUrls": [
    { "environment": "local", "url": "http://localhost:8000" },
    { "environment": "production", "url": "" }
  ]
}

You can add your production URL in that file. Local URL is guessed from common patterns (e.g. app.run(port=5000), uvicorn.run(..., port=8000)).

Requirements

• Python 3.8+
• Internet connection (to talk to the Frumle API)

Other platforms

• Node.js / TypeScript: npm install -g frumle → npm
• Java (Maven): mvn frumle:add-key then mvn frumle:start → Maven Central
• Java (Gradle): ./gradlew frumle → Gradle Plugin Portal

Publishing to PyPI (maintainers)

cd py-package
pip install build twine
python -m build
twine upload dist/*

Use a PyPI account and token (or ~/.pypirc) for uploads.

License

MIT © Tellecata LLC