Atlas • Dependency Firewall • FastAPI tooling • MCP (optional)

Everything you need for verifiable FastAPI changes

Local-first analysis and policy enforcement for Python projects—grounded in code truth and machine-readable outputs.

Local-first

Runs on your machine

.ranex/

Project state

--json

Automation output

MCP

Optional integration

Atlas (Code Intelligence)

Local-first indexing for Python

Index your codebase once, then use search, dependency graphs, impact analysis, and span-first retrieval to ground edits in evidence.

.ranex/atlas.sqlite

Local index DB

AST

Python parsing

Imports + Calls

Graphs

--json

Tooling output

Scan & index

Production

Build the project index under .ranex/ so queries are fast and reproducible.

ranex atlas scan

Name-based search

Production

Find symbols and modules quickly (use --json for stable automation contracts).

ranex atlas search "<query>"

Dependency & impact analysis

Production

Estimate blast radius using import/call graphs before making risky changes or refactors.

ranex atlas file-impact <file_path>

Cycles, duplicates, and patterns

Production

Find dependency cycles and potential duplication. These are heuristic signals meant to guide review.

ranex atlas cycles / duplicates

Span-first retrieval

Production

Get verifiable (file, start_line, end_line) spans instead of guessing or dumping full files.

ranex atlas search-spans / read-span

Security-aware indexing & reading

Production

Optional deny rules prevent indexing/reading sensitive paths when running Atlas via tooling/AI.

.ranex/config.toml [security]

Dependency Firewall

Policy-based import validation

Validate imports against an explicit policy to prevent risky patterns, typosquatting, and accidental/hallucinated dependencies.

.ranex/firewall.yaml

Policy file

strict

Fail-closed

audit_only

Report mode

Exit 2

Blocked import

Check one import

Production

Validate a single import path against your policy.

ranex firewall check-import <import_path>

Analyze a file

Production

Scan a Python file and evaluate its imports against the firewall policy.

ranex firewall analyze-file <file_path>

Typosquatting detection

Production

Detect suspicious lookalike package names before they enter your dependency graph.

ranex firewall typosquat <package_name>

Policy inspection

Production

Audit current mode, allowlists, blocked patterns, and rules for review/CI.

ranex firewall info / list-rules

Python API

Production

Use Firewall(project_root) to validate imports programmatically.

from ranex import Firewall

FastAPI Analysis

Endpoint extraction + reports

Static analysis for FastAPI services: endpoint discovery, router topology, scaling checks, and truth capsules for verifiable endpoint context.

Decorators

Endpoint detection

.ranex/fastapi_scaling.yaml

Policy (optional)

Router topology

Structure report

Truth capsule

Endpoint bundle

Endpoint discovery

Production

Detect FastAPI endpoints via HTTP-method decorators and store method/path metadata when statically provable.

ranex atlas scan

Scaling analysis (policy-driven)

Production

Run a static report to surface patterns that can cause performance or scalability issues (not runtime profiling).

ranex atlas fastapi-scaling-report --json

Router topology

Production

Understand how routes are split across routers vs direct app routes (useful as services grow).

ranex atlas fastapi-router-topology --json

Truth capsule (static endpoint bundle)

Production

Generate a structured JSON bundle for one endpoint/handler with grouped spans and unresolved edges when static proof is missing.

ranex atlas fastapi-truth-capsule --json

Interfaces

CLI + Python API + MCP

Use Ranex from the CLI, programmatically from Python, or from MCP-compatible AI assistants via a local stdio server.

CLI

Human entrypoint

--json

Automation output

Python

Atlas + Firewall

MCP

AI assistant integration

CLI commands

Production

Scan and query from a terminal with consistent flags like --project-root and --json.

ranex atlas ... / ranex firewall ...

Python API

Production

Use Atlas(project_root) and Firewall(project_root) in scripts/tests for automation.

from ranex import Atlas, Firewall

MCP server (optional)

Production

Expose Atlas and Firewall tools over stdio to MCP-compatible assistants using RANEX_PROJECT_ROOT.

ranex-mcp-server

Span-first MCP workflows

Production

Use search-spans and read-span to ground assistants in verifiable file/line ranges.

ranex_atlas_search / ranex_atlas_read_span

MCP environment variables

Production

Select project root and log level without changing client configuration.

RANEX_PROJECT_ROOT / RANEX_LOG

Configuration & Privacy

Project-local state under .ranex/

Ranex is local-first by design. Configuration and state live inside your project directory and can be controlled via config files and deny rules.

.ranex/

Project state

.ranexignore

Scan scope

.ranex/config.toml

Optional config

Local-first

No cloud by default

Project-local files

Production

Atlas DB, firewall policy, and optional FastAPI scaling policy live under .ranex/.

.ranex/atlas.sqlite / .ranex/firewall.yaml

Ignore file

Production

Exclude directories/files you do not want indexed during scans.

.ranexignore

Security allow/deny rules

Production

Prevent indexing/reading sensitive file types and directories when using Ranex via automation or AI assistants.

.ranex/config.toml [security]

Recommended practices

Production

Commit firewall.yaml (policy as code). Do not commit atlas.sqlite unless you have a reason.

DOCS/END-USER/PRIVACY_SECURITY.md

✦ Local-first by default

Drop-in project setup

Install Ranex, initialize a firewall policy, and build an Atlas index. All project state lives under .ranex/.

Project-local state

Atlas DB

Index metadata + graphs

.ranex/atlas.sqlite

Firewall policy

Policy-as-code

.ranex/firewall.yaml

FastAPI policy

Optional scaling rules

.ranex/fastapi_scaling.yaml

# Install (recommended: in a venv)

$ pip install ranex

# Verify + initialize firewall policy

$ ranex version

$ ranex init

# Build Atlas index + query

$ ranex atlas scan

$ ranex atlas search "payment" --json

Ready to get started?

Install Ranex and follow the end-user docs for Atlas, Firewall, and MCP integration.

Read the docs Installation

Atlas • Dependency Firewall • FastAPI tooling • MCP (optional)

Everything you need for verifiable FastAPI changes

Local-first analysis and policy enforcement for Python projects—grounded in code truth and machine-readable outputs.

Local-first

Runs on your machine

.ranex/

Project state

--json

Automation output

MCP

Optional integration

Atlas (Code Intelligence)

Local-first indexing for Python

Index your codebase once, then use search, dependency graphs, impact analysis, and span-first retrieval to ground edits in evidence.

.ranex/atlas.sqlite

Local index DB

AST

Python parsing

Imports + Calls

Graphs

--json

Tooling output

Scan & index

Production

Build the project index under .ranex/ so queries are fast and reproducible.

ranex atlas scan

Name-based search

Production

Find symbols and modules quickly (use --json for stable automation contracts).

ranex atlas search "<query>"

Dependency & impact analysis

Production

Estimate blast radius using import/call graphs before making risky changes or refactors.

ranex atlas file-impact <file_path>

Cycles, duplicates, and patterns

Production

Find dependency cycles and potential duplication. These are heuristic signals meant to guide review.

ranex atlas cycles / duplicates

Span-first retrieval

Production

Get verifiable (file, start_line, end_line) spans instead of guessing or dumping full files.

ranex atlas search-spans / read-span

Security-aware indexing & reading

Production

Optional deny rules prevent indexing/reading sensitive paths when running Atlas via tooling/AI.

.ranex/config.toml [security]

Dependency Firewall

Policy-based import validation

Validate imports against an explicit policy to prevent risky patterns, typosquatting, and accidental/hallucinated dependencies.

.ranex/firewall.yaml

Policy file

strict

Fail-closed

audit_only

Report mode

Exit 2

Blocked import

Check one import

Production

Validate a single import path against your policy.

ranex firewall check-import <import_path>

Analyze a file

Production

Scan a Python file and evaluate its imports against the firewall policy.

ranex firewall analyze-file <file_path>

Typosquatting detection

Production

Detect suspicious lookalike package names before they enter your dependency graph.

ranex firewall typosquat <package_name>

Policy inspection

Production

Audit current mode, allowlists, blocked patterns, and rules for review/CI.

ranex firewall info / list-rules

Python API

Production

Use Firewall(project_root) to validate imports programmatically.

from ranex import Firewall

FastAPI Analysis

Endpoint extraction + reports

Static analysis for FastAPI services: endpoint discovery, router topology, scaling checks, and truth capsules for verifiable endpoint context.

Decorators

Endpoint detection

.ranex/fastapi_scaling.yaml

Policy (optional)

Router topology

Structure report

Truth capsule

Endpoint bundle

Endpoint discovery

Production

Detect FastAPI endpoints via HTTP-method decorators and store method/path metadata when statically provable.

ranex atlas scan

Scaling analysis (policy-driven)

Production

Run a static report to surface patterns that can cause performance or scalability issues (not runtime profiling).

ranex atlas fastapi-scaling-report --json

Router topology

Production

Understand how routes are split across routers vs direct app routes (useful as services grow).

ranex atlas fastapi-router-topology --json

Truth capsule (static endpoint bundle)

Production

Generate a structured JSON bundle for one endpoint/handler with grouped spans and unresolved edges when static proof is missing.

ranex atlas fastapi-truth-capsule --json

Interfaces

CLI + Python API + MCP

Use Ranex from the CLI, programmatically from Python, or from MCP-compatible AI assistants via a local stdio server.

CLI

Human entrypoint

--json

Automation output

Python

Atlas + Firewall

MCP

AI assistant integration

CLI commands

Production

Scan and query from a terminal with consistent flags like --project-root and --json.

ranex atlas ... / ranex firewall ...

Python API

Production

Use Atlas(project_root) and Firewall(project_root) in scripts/tests for automation.

from ranex import Atlas, Firewall

MCP server (optional)

Production

Expose Atlas and Firewall tools over stdio to MCP-compatible assistants using RANEX_PROJECT_ROOT.

ranex-mcp-server

Span-first MCP workflows

Production

Use search-spans and read-span to ground assistants in verifiable file/line ranges.

ranex_atlas_search / ranex_atlas_read_span

MCP environment variables

Production

Select project root and log level without changing client configuration.

RANEX_PROJECT_ROOT / RANEX_LOG

Configuration & Privacy

Project-local state under .ranex/

Ranex is local-first by design. Configuration and state live inside your project directory and can be controlled via config files and deny rules.

.ranex/

Project state

.ranexignore

Scan scope

.ranex/config.toml

Optional config

Local-first

No cloud by default

Project-local files

Production

Atlas DB, firewall policy, and optional FastAPI scaling policy live under .ranex/.

.ranex/atlas.sqlite / .ranex/firewall.yaml

Ignore file

Production

Exclude directories/files you do not want indexed during scans.

.ranexignore

Security allow/deny rules

Production

Prevent indexing/reading sensitive file types and directories when using Ranex via automation or AI assistants.

.ranex/config.toml [security]

Recommended practices

Production

Commit firewall.yaml (policy as code). Do not commit atlas.sqlite unless you have a reason.

DOCS/END-USER/PRIVACY_SECURITY.md

✦ Local-first by default

Drop-in project setup

Install Ranex, initialize a firewall policy, and build an Atlas index. All project state lives under .ranex/.

Project-local state

Atlas DB

Index metadata + graphs

.ranex/atlas.sqlite

Firewall policy

Policy-as-code

.ranex/firewall.yaml

FastAPI policy

Optional scaling rules

.ranex/fastapi_scaling.yaml

# Install (recommended: in a venv)

$ pip install ranex

# Verify + initialize firewall policy

$ ranex version

$ ranex init

# Build Atlas index + query

$ ranex atlas scan

$ ranex atlas search "payment" --json

Ready to get started?

Install Ranex and follow the end-user docs for Atlas, Firewall, and MCP integration.

Read the docs Installation