Metadata-Version: 2.4
Name: beeq
Version: 1.0.0
Summary: The first AI hive. One curl. One queen. An army that works.
Project-URL: Homepage, https://beeq.run
Project-URL: Documentation, https://beeq.run/docs/
Project-URL: Repository, https://github.com/ElmadaniS/beeq
Project-URL: Verify actions, https://beeq.run/verify/
Author-email: Elmadani SALKA <Elmadani.SALKA@proton.me>
License: BSL-1.1
Keywords: aap,agents,ai,beeq,hive,llm,orchestration,queen
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: anthropic>=0.25.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: click>=8.1.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: fastapi>=0.111.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: ollama>=0.2.0
Requires-Dist: openai>=1.30.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.7.0
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: hatchling; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# BeeQ

**The first AI hive. One curl. One queen. An army that works.**

```bash
curl -fsSL https://beeq.run/install | bash
```

```
BeeQ Hive Status
┏━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┓
┃ Component       ┃ Status            ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━┩
│ Queen           │ ready             │
│ Audit chain     │ valid — 0 entries │
│ Worker-research │ active            │
│ Worker-code     │ active            │
│ Worker-write    │ active            │
│ Worker-ops      │ active            │
└─────────────────┴───────────────────┘
```

Every action signed. Every action traceable.
Every action reversible. You remain sovereign.

---

## Install

```bash
# Option 1 — one curl (recommended)
curl -fsSL https://beeq.run/install | bash

# Option 2 — pip
pip install beeq
beeq connect ollama   # or: beeq connect claude --key sk-ant-...
beeq start
```

## Usage

```bash
beeq start                        # start your hive interactively
beeq mission "prepare my weekly report"   # single mission
beeq status                       # hive status
beeq audit                        # view full audit chain
beeq revoke research              # revoke a worker (LEX §5)
```

## What makes BeeQ different

| | Others | BeeQ |
|---|---|---|
| Agent cryptographic identity | ✗ | ✅ AAP |
| Signed delegation chain | ✗ | ✅ scope(worker) ⊂ scope(queen) |
| Tamper-evident audit | ✗ | ✅ hash chain |
| Physical world (robots/IoT) | ✗ | ✅ NRP |
| Physical World Rule | ✗ | ✅ Level 4 forbidden |
| LLM-agnostic | partial | ✅ Claude/OpenAI/Ollama/GGUF |
| Local-first | ✗ | ✅ your data never leaves |
| Single curl install | partial | ✅ |

## Architecture

```
HUMAN  (sovereign — gives mission, validates decisions)
  ↓
QUEEN  (orchestrates — decomposes, delegates, reports)
  ↓
WORKERS (execute within signed AAP scope)
  ├─ research   web · APIs · documents
  ├─ code       files · git · execution
  ├─ write      emails · articles · reports
  └─ ops        infrastructure · monitoring
```

## Governed by

- **LEX** — 11 civilizational laws (MIT)
- **PHY** — 7 physical laws for embodied agents (MIT)
- **AAP** — Agent Accountability Protocol (MIT)
- **NRP** — Node Reach Protocol for physical world (MIT)

## License

BSL-1.1 — Free for individuals, research, open source.
Commercial use requires a license.

See [beeq.run](https://beeq.run) for details.
