Metadata-Version: 2.4
Name: praxis-ai
Version: 0.1.1
Summary: CI reliability gate for AI agents
Project-URL: Homepage, https://github.com/Tile-Labs/Praxis
Project-URL: Repository, https://github.com/Tile-Labs/Praxis
Project-URL: Issues, https://github.com/Tile-Labs/Praxis/issues
Author: Tile Labs
License: Proprietary
Keywords: agents,ci,evals,langgraph,reliability
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: <3.14,>=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.8.0
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.12.0
Provides-Extra: dev
Requires-Dist: mypy>=1.11.0; extra == 'dev'
Requires-Dist: pytest<9.0.0,>=8.2.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Description-Content-Type: text/markdown

# Praxis

Praxis is a CI reliability gate for AI agents. The MVP attacks every pull request with agent-specific task evals, runs checked-in regression cases, and surfaces generated failures for review.

The current implementation is a scaffolded MVP:

- Python CLI distribution `praxis-ai` in `packages/praxis-python`
- Next.js local dashboard in `apps/dashboard`
- Deterministic black-box stubs for introspection, stress generation, and RCA
- GitHub Action scaffolding for PR comments

## Quick Start

```bash
make install
make test
```

Once published, install the CLI with:

```bash
pipx install praxis-ai
praxis --help
```

Run against a client repo with deterministic local behavior:

```bash
uv run praxis init --repo /path/to/demo-client-agent
uv run praxis run --repo /path/to/demo-client-agent --stub
uv run praxis generate-agent-tests --repo /path/to/demo-client-agent
```

Start the dashboard:

```bash
make dashboard-install
make dashboard
```

## MVP Scope

Praxis currently treats introspection, adversarial generation, and RCA as replaceable stubs. The first real adapter targets the Python/LangGraph `demo-client-agent`.

## Release

The PyPI distribution name is `praxis-ai` because `praxis` is already occupied on PyPI. The console command remains `praxis`.

Publishing uses PyPI Trusted Publishing from `.github/workflows/publish.yml`. Configure the PyPI project `praxis-ai` to trust this repository, workflow `publish.yml`, and environment `pypi`, then publish a GitHub release such as `v0.1.0`.
