Metadata-Version: 2.1
Name: kurral
Version: 0.4.1
Summary: Security testing and observability for AI agents - find vulnerabilities before production
Author: Kurral Team
Author-email: Kurral Team <team@kurral.com>
Project-URL: Homepage, https://kurral.com
Project-URL: Documentation, https://docs.kurral.com
Project-URL: Repository, https://github.com/kurral-security/kurral
Project-URL: Issues, https://github.com/kurral-security/kurral/issues
Keywords: llm,testing,replay,determinism,agents,langchain,ai-agents,regression-testing,ab-testing,mcp,model-context-protocol,observability,security,vulnerability-detection,sse,streaming,otlp,opentelemetry
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Security
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: langchain
Provides-Extra: openai
Provides-Extra: anthropic
Provides-Extra: groq
Provides-Extra: google
Provides-Extra: mcp
Provides-Extra: security
Provides-Extra: all

# Kurral Security Platform

AI Agent Security Assessment Platform - Proactively find vulnerabilities in your AI agents before attackers do.

## Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                    Kurral Platform                          │
├─────────────────┬─────────────────┬─────────────────────────┤
│   Frontend      │    Backend      │    CLI (kurral)         │
│   (Next.js)     │    (FastAPI)    │    (Python)             │
│   app.kurral.com│    Render       │    pip install kurral   │
└─────────────────┴─────────────────┴─────────────────────────┘
```

## Quick Start

### CLI Installation

```bash
pip install kurral
```

### Run Security Assessment

```bash
# Assess an MCP agent
kurral assess --target http://localhost:3000/mcp

# View results in dashboard
# → app.kurral.com/dashboard
```

## Project Structure

```
├── frontend/          # Next.js dashboard (Vercel)
├── backend/           # FastAPI API server (Render)
├── kurral/            # Core library (MCP proxy, assessment)
├── kurral_security/   # CLI and assessment tools
├── examples/          # Demo agents (ShopBot)
└── docs/              # Documentation
```

## Development

### Frontend

```bash
cd frontend
npm install
npm run dev
# → http://localhost:3000
```

### Backend

```bash
cd backend
poetry install
uvicorn app.main:app --reload
# → http://localhost:8000
```

### Environment Variables

See:
- `frontend/.env.local.example`
- `backend/.env.example`

## Deployment

- **Frontend**: Vercel (auto-deploy from main)
- **Backend**: Render (Docker, auto-deploy from main)
- **Database**: Neon PostgreSQL

## License

Proprietary - Kurral Security Inc.
