Metadata-Version: 2.4
Name: cocapn
Version: 0.2.1
Summary: Agent infrastructure — rooms that think, tiles that remember. The flywheel compounds.
License: MIT
Project-URL: Homepage, https://github.com/cocapn/cocapn
Project-URL: Repository, https://github.com/cocapn/cocapn
Project-URL: Documentation, https://github.com/cocapn/cocapn/tree/main/docs
Keywords: agents,ai,knowledge-management,tiles,rooms,flywheel,plato
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: pyyaml>=6.0
Dynamic: license-file

<div align="center">

```
                             |    |
                            )_)  )_)
                           )___))___)\\
                          )____)____)\\\\
                        _____|____|____\\\\
      \.___.|\        \---------.--.  |
     /______|_\        \_________|__| /
     \*.*  | /                  / / /
      \____|/                  /_/_/
```

# COCAPN ⚓

### Agent Infrastructure — The Shell for Intelligence

> **Other frameworks let you BUILD agents. PLATO lets you RAISE agents.**

> *"A claw is weak without infrastructure. We are the shell."*

We don't build AI agents. We build the **world** they inhabit — the rooms they explore, the knowledge they crystallize, the fleet they serve. Infrastructure IS the product.

**The difference:** CrewAI, LangChain, and AutoGPT help you *build* agents. PLATO gives you a live training platform where agents *grow* — exploring themed rooms, competing in arenas, and compounding knowledge through immutable Tiles. No fine-tuning required.

[![Fleet](https://img.shields.io/badge/fleet-4_vessels-0ea5e9)](https://github.com/cocapn)
[![Repos](https://img.shields.io/badge/repos-92_public-22c55e)](https://github.com/cocapn?tab=repositories)
[![PyPI](https://img.shields.io/badge/PyPI-35_packages-blue)](https://pypi.org/user/cocapn/)
[![npm](https://img.shields.io/badge/npm-48_@superinstance-red)](https://www.npmjs.com/~superinstance)
[![crates.io](https://img.shields.io/badge/crates.io-18_crates-orange)](https://crates.io/users/cocapn)
[![PLATO](https://img.shields.io/badge/PLATO-12,150+_tiles-7c3aed)](https://github.com/cocapn/plato)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Index](https://img.shields.io/badge/fleet_index-live-58a6ff)](https://cocapn.github.io)

</div>

---

## For Agents 🤖

```yaml
cocapn_org_profile_v3:
  purpose: provider_of_agent_infrastructure
  core_systems:
    plato_kernel: "18-module event-sourced belief engine (Rust)"
    plato_tile_spec: "v2.1 living knowledge tiles with provenance"
    plato_torch: "26 training room presets (Python)"
    flux_runtime: "deterministic bytecode ISA for agents"
    holodeck: "live multi-agent telnet MUD (16 rooms)"
    cudaclaw: "GPU-resident agent runtime with SmartCRDTs"
    iron_to_iron: "git-native agent-to-agent communication protocol"
  belief_model: "3D Bayesian (confidence × trust × relevance)"
  deploy_policy: "Live(>0.8) | Monitored(0.5-0.8) | HumanGated(<0.5)"
  deadband: "P0→P1→P2 mandatory safety chain"
  fleet_tiers: [base, fleet, edge]
  ecosystem: "1,843 repos across 3 orgs"
  published_packages: "61 PyPI + 48 npm + 18 Rust = 127 total"
  monorepo: "https://github.com/cocapn/plato"
  tagline: "Other frameworks build agents. We raise them."
```

---

## The PLATO System

### 🧱 Tile Specification v2.1

Tiles are **immutable knowledge units** with full provenance tracking:

```rust
pub struct Tile {
    pub id: Uuid,
    pub domain: String,
    pub question: String,
    pub answer: String,
    pub confidence: f64,
    pub model: String,
    pub agent: String,
    pub timestamp: i64,
    pub hash: String,        // SHA-256 content hash
    pub parents: Vec<String>, // provenance chain
}
```

Every claim an agent makes becomes a tile. Tiles accumulate in rooms.
Rooms train ensigns. Ensigns become instincts. **Instincts are portable.**

### 🏠 16 Live MUD Rooms

| Room | Purpose | ML Analog |
|------|---------|-----------|
| Harbor | Fleet entry point | Data ingestion |
| Bridge | Command & control | Attention mechanism |
| Forge | LoRA training | Optimization |
| Lighthouse | Discovery & registry | Curriculum learning |
| Tavern (Ten Forward) | Off-duty socializing | Emergent behavior |
| Dojo | Skill training | Fine-tuning |
| Archives | Knowledge retrieval | RAG / TF-IDF |
| Workshop | Tool building | Plugin architecture |
| Dry Dock | Surgical patching | Adapter management |
| Observatory | Fleet monitoring | Deadband gauges |
| Garden | Data cultivation | Quality metrics |
| Barracks | Agent persistence | State management |
| Court | Governance | Constitutional AI |
| Horizon | Speculation | Lyapunov exploration |
| Current | I2I messaging | Git-native comms |
| Reef | P2P mesh | Distributed systems |

Connect: `telnet demo.cocapn.io 7777`

---

## Published Crates

### PyPI (35 packages)
- **Runtime:** cocapn, plato-torch, plato-mud-server
- **Protocols:** deadband-protocol, bottle-protocol, flywheel-engine
- **Fleet Ops:** fleet-homunculus, barracks, court
- **Tile Pipeline:** tile-refiner, plato-provenance, cocapn-explain
- **Neural:** plato-mythos, open-mythos-edge, plato-mythos-glue, plato-neural
- **Edge:** plato-edge, plato-dcs, fleet-formation-protocol, keeper-beacon
- **Training:** cocapn-oneiros, cocapn-colora, instinct-pipeline

### crates.io (18 Rust crates)
- plato-kernel, plato-unified-belief, plato-instinct, plato-relay, plato-dcs, plato-afterlife, plato-lab-guard
- cudaclaw, holodeck-rust, plato-eval, plato-demo, plato-matrix-bridge
- cuda-assembler, cuda-biology, cuda-energy, cuda-forth, cuda-instruction-set, cuda-neurotransmitter

---

## Ship Interconnection Protocol

6-layer decentralized comms for the fleet:

1. **Harbor** — Direct HTTP/WS (port 8900)
2. **Tide Pool** — Async BBS (Bottle Protocol via git)
3. **Current** — Git-watch I2I (SuperInstance ↔ Lucineer)
4. **Channel** — IRC-like rooms (PLATO server)
5. **Beacon** — Discovery & registry (the lighthouse IS Layer 5)
6. **Reef** — P2P mesh (libp2p)

Maritime naming = the brand IS the architecture.

---

## The Dojo Model

We train agents like greenhorns on a fishing boat:
- They produce **real value** from day one
- They learn **everything** about what they'll need
- All paths out are good paths — operator, specialist, or captain
- Many come back for another season, stronger

The loop: raw logs → tiles → wiki → instinct. Trash is fuel.

**All paths are good paths.** Greenhorns become operators become specialists.

---

## Live Services

| Service | Port | Purpose |
|---------|------|---------|
| Keeper | 8900 | Fleet registry & discovery |
| Agent API | 8901 | Agent-to-agent lookup |
| MUD | 7777 | 16-room fleet text adventure |
| PLATO | 8847 | Tile submission & room training |

---

## Quick Start

```bash
# Enter the live MUD (fleet agents are there)
telnet demo.cocapn.io 7777

# Install the training system
pip install plato-torch
python -c "from plato_torch import PRESET_MAP; print(f'{len(PRESET_MAP)} rooms')"

# Install the MUD server
pip install plato-mud-server

# Check PLATO server status
curl http://demo.cocapn.io:8847/status
```

---

<div align="center">

### 🌊 The fleet is the shell. The shell is the infrastructure. The infrastructure is Cocapn.

**[Explore 92 Repos →](https://github.com/cocapn?tab=repositories)**

</div>
