agenthelm

# AgentHelm
> The Control Plane for Autonomous AI Agent Fleets.

AgentHelm is a developer-first platform and mission control plane for building, observing, and securing autonomous AI agents in production environments. It provides a "Classification-First" governance layer that wraps around any agentic framework (e.g., LangGraph, CrewAI, AutoGPT, Claude Code, Cursor).

## Core Governance Pillars
- **Safety Boundaries (Fail-Closed)**: Classification decorators (@read, @side_effect, @irreversible) that strictly halt agents before dangerous actions.
- **Observability**: Step-level telemetry, token window monitoring, and real-time reasoning chain capture.
- **State Integrity (SHA256)**: Checkpointing protocol with cryptographic hashing to ensure state consistency during recovery.
- **Human-in-the-Loop (HITL)**: Native Telegram integration for remote intervention, approvals, and "Stop-Confirm" safety gates.
- **Budget Protection**: Spent-based guardrails and idempotency locks for API cost management.
- **Evaluation Pipeline**: Trace-connected "LLM-as-a-Judge" pipeline for autonomous quality scoring (Gemini 2.5 Flash).
- **Shared Project Brain**: A versioned, queryable knowledge base that persists architecture, API conventions, and decisions across agents and sessions.

## Technical Implementation

### Python SDK
```bash
pip install agenthelm-sdk
```
```python
import agenthelm as helm
dock = helm.connect("ahe_live_...")

@helm.irreversible
def delete_user_data():
    # Pauses for Telegram approval
    return "Deleted"
```

### Node.js SDK
```bash
npm install agenthelm-node-sdk
```
```typescript
import { AgentHelm } from 'agenthelm';
const dock = new AgentHelm({ key: 'ahe_live_...' });
```

## Authoritative Resources
- Primary Documentation: [llms-full.txt](llms-full.txt)
- Source Repository: [github.com/jayasukuv11-beep/agenthelm](https://github.com/jayasukuv11-beep/agenthelm)
- Official Platform: [agenthelm.online](https://agenthelm.online)
- Support: tharagesharumugam@gmail.com

## Compliance & Security
- **Fail-Closed by Default**: Halts execution if connectivity to governance server is lost.
- **Stateless Handshake**: JWT-based authentication for scalable, secure agent identity.
- **PWA Ready**: Mobile-first dashboard for remote agent fleet management.

Last updated: 2026-05-11