Metadata-Version: 2.4
Name: nablr
Version: 4.3.22
Summary: nablr — AI-powered SDLC governance. 19 expert personas enforcing quality gates via Model Context Protocol (MCP).
Project-URL: Homepage, https://nablr.dev
Project-URL: Repository, https://github.com/nablrco/nablr
Project-URL: Bug Tracker, https://github.com/nablrco/nablr/issues
Author-email: Mishtert T <Mishtert.Thangaraj@myridius.com>
License: Proprietary
License-File: LICENSE
Keywords: agents,ai,code-quality,governance,mcp,relay-engineering,sdlc
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.12
Requires-Dist: fastmcp<4.0.0,>=3.4.2
Requires-Dist: mcp>=1.25.0
Requires-Dist: networkx>=3.4
Requires-Dist: pydantic>=2.12.5
Requires-Dist: structlog>=25.5.0
Requires-Dist: tree-sitter-markdown>=0.3.0
Requires-Dist: tree-sitter-python>=0.21.0
Requires-Dist: tree-sitter-typescript>=0.21.0
Requires-Dist: tree-sitter>=0.21.0
Requires-Dist: watchdog>=4.0.0
Description-Content-Type: text/markdown

# nablr

![Security Scan](https://github.com/nablrco/nablr/actions/workflows/security-scan.yml/badge.svg)
![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)
![PyPI](https://img.shields.io/pypi/v/nablr)

**AI-powered SDLC governance via Model Context Protocol.**

**nablr** *(pronounced like "enabler")* connects to your AI assistant (Cursor, Claude Desktop, Windsurf) and enforces quality gates across your entire software delivery lifecycle — 19 expert personas, 40+ local code scanners, full workflow orchestration.

> Documentation: [docs.nablr.dev](https://docs.nablr.dev)

---

## Why nablr

AI assistants accelerate typing, not engineering.

| What they promised | What actually happens |
|--------------------|----------------------|
| Ship faster | More code, same bugs |
| Higher quality | AI-generated tech debt |
| Reduce costs | Increased rework cycles |

nablr is the orchestration layer that fixes this: quality enforcement, workflow context, and persistent state injected directly into your AI assistant via MCP.

---

## Free vs paid

| Capability | Free | Pro |
|-----------|------|-----|
| 40+ code scanners | ✅ | ✅ |
| Workflow orchestration | ✅ | ✅ |
| Codebase mapping | ✅ | ✅ |
| 19 expert persona prompts | — | ✅ |
| 34 rule files | — | ✅ |
| Language + framework configs | — | ✅ |
| 14-day trial (full Pro) | ✅ | — |

---

## Installation

Requires [`uv`](https://docs.astral.sh/uv/getting-started/installation/).

Add to your AI assistant config:

```json
{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"]
    }
  }
}
```

Config file locations:
- **Cursor**: `~/.cursor/mcp.json`
- **Claude Desktop** (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windsurf**: `~/.codeium/windsurf/mcp_config.json`

Restart your AI assistant after saving. Full setup guide at [docs.nablr.dev/quickstart](https://docs.nablr.dev/quickstart).

---

## Quick start

```
# Entry point — loads nablr context into your AI assistant
activate nablr

# Start a 14-day free trial (no credit card)
Start my nablr trial

# Invoke a persona
Set agent to developer

# Run a scanner
Scan this directory for technical debt

# Full SDLC workflow
Set agent to discovery  →  Set agent to architect  →  Set agent to developer
```

---

## Personas

19 expert agents covering every SDLC phase: Discovery, Product Manager, QA Lead, Specifier, Architect, Developer, Tester, Test Designer, PR Reviewer, Scrum Master, Security Owner, Forensic Engineer, Strategist, Platform Engineer, Impact Architect, Migration Planner, Parity Tester, Cutover Engineer.

`discovery` and `platform_engineer` are permanently free.

---

## Security

nablr makes exactly one category of outbound call: license validation to `nablr-api.nablrco.workers.dev:443`. Your code never leaves your machine.

Paid assets are pre-cached to `~/.nablr_cache/assets/` on activation — all subsequent prompt generation works fully offline.

```bash
# Verify no unexpected network calls
uv run python scripts/airgap_proof.py
```

Full security details at [docs.nablr.dev/security](https://docs.nablr.dev/security).

---

## License

Proprietary. All rights reserved. © nablr
