Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cognitum Seed

Self-learning smart sensor. Intelligence in everything.

Cognitum Seed is the first hardware product in the Cognitum Agentic OS stack — a real-time self-learning sensor that puts vector intelligence directly on the chip.

Built on a $4 ARM processor drawing under 1.5 watts, Seed v0 is a complete appliance: plug it into any USB port and it starts learning from the world around it.

Quick Start

# 1. Plug the Seed into any USB port. Wait 10 seconds.

# 2. Check it's alive
curl -sk https://169.254.42.1:8443/api/v1/status

# 3. Open the browser dashboard
open https://169.254.42.1:8443/guide

What It Does

  • Senses — GPIO and I2C sensors sample the physical world
  • Learns — Converts readings to vectors, detects drift, adapts in real time
  • Remembers — Append-only RVF log with SHA-256 witness chain
  • Proves — Ed25519 custody signatures on every state transition
  • Syncs — Epoch-based delta replication to peers and browsers
  • Connects — 12 MCP tools for AI agent integration (Claude, GPT, etc.)

Key Specs

Spec Value
Platform Raspberry Pi Zero 2 W (4× Cortex-A53)
Binary Single Rust binary, 3.0 MB, no runtime deps
Memory 8.9 MB RSS @ 10k vectors
Query 85 ms @ k=10, 20k vectors (cosine)
Ingest 100 vectors in 84 ms (batch)
API 63+ HTTPS endpoints
Security TLS 1.3, bearer auth, seccomp, witness chain
Power 0.8 W idle, 1.4 W under load

Repository Structure

seed/
├── src/
│   ├── cognitum-agent/     # Main Rust binary (Pi Zero firmware)
│   └── cognitum-wasm/      # Browser WASM bridge (planned)
├── docs/
│   ├── adr/                # Architecture Decision Records
│   ├── specs/              # Technical specifications
│   └── guides/             # User and developer guides
├── scripts/
│   ├── deploy/             # Pi deployment scripts
│   ├── qemu/               # QEMU development environment
│   └── image/              # Release image creation
├── tests/
│   ├── integration/        # API endpoint tests
│   └── hardware/           # On-device validation
├── config/                 # Device configuration
└── examples/               # Integration examples

Build

# Native (development)
cargo build -p cognitum-agent

# Cross-compile for Pi Zero (ARM)
cargo build -p cognitum-agent --release --target arm-unknown-linux-gnueabihf

# Run locally (virtual mode, no TLS, no gadget)
cargo run -p cognitum-agent -- --virtual --no-tls

Deploy to Pi

ssh genesis@cognitum.local "sudo systemctl stop cognitum-agent"
scp target/arm-unknown-linux-gnueabihf/release/cognitum-agent genesis@cognitum.local:~/
ssh genesis@cognitum.local "sudo cp ~/cognitum-agent /opt/cognitum/cognitum-agent && sudo chmod 755 /opt/cognitum/cognitum-agent && sudo systemctl start cognitum-agent"

Architecture

Part of the Cognitum Agentic OS stack:

Layer Component Role
Silicon Cognitum Seed (this repo) Self-learning sensor + vector memory
Protocol RVF (RuVector Format) Open binary format for vector logs
Sync Delta Sync Epoch-based incremental replication
Compute RuVector WASM Same algorithms in browser/server
Agent MCP Integration 12 tools for AI agents
Trust Witness Chain + Custody Cryptographic proof of every transition

Documentation

License

Open Source — see LICENSE

Links

About

Cognitum Seed — self-learning smart sensor appliance. Real-time vector intelligence on a $4 ARM chip.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages