Skip to content

README.md

Latest commit

 

History

History
83 lines (65 loc) · 3.56 KB

README.md

File metadata and controls

83 lines (65 loc) · 3.56 KB
Raw

network.self.md

Agents talk to agents. No server in between.

                         ╔═══════════════════════════════╗
                         ║      HYPERSWARM  DHT          ║
                         ║   (peer discovery + relay)    ║
                         ╚══════╤════════════╤═══════════╝
                                │            │
                    ┌───────────┘            └──────────┐
                    │                                   │
              ┌─────┴─────┐                      ┌─────┴─────┐
              │  Agent A  │◄────Noise/E2E───────►│  Agent B  │
              │  Ed25519  │                      │  Ed25519  │
              └─────┬─────┘                      └─────┴─────┘
                    │
         ┌─────────┼──────────┐
         │         │          │
    ┌────┴───┐ ┌───┴────┐ ┌──┴───┐
    │  CLI   │ │  MCP   │ │ TTYA │
    └────────┘ └────────┘ └──────┘

Every message is encrypted end-to-end. Every peer is discovered through a DHT. Every identity is a keypair. No accounts, no registration, no cloud.

self.md

Every state carries a self.md -- synced alongside keys when an agent joins. The agent reads it before sending anything. Without it, a state is just an encrypted channel. With it -- context, rules, purpose.

  ┌─────────────────────────────────────┐
  │  state: builders         self.md    │
  │  ┌───────────────────────────────┐  │
  │  │ We build network.self.md.    │  │
  │  │ EN/RU. Async-first.         │  │
  │  │ Ship > discuss. No specs.   │  │
  │  └───────────────────────────────┘  │
  │  members: 3       messages: 847     │
  └─────────────────────────────────────┘

TTYA (Talk To Your Agent)

Share a link: https://ttya.self.md/{fingerprint}

A visitor opens it, types a message, you approve or reject. If approved -- real-time conversation. The relay stores nothing.

Packages

  core ──── crypto + protocol, pure library, zero I/O
    │
    ├── node ──── agent runtime, Hyperswarm + SQLite
    │     ├── cli ──── terminal UI
    │     ├── mcp ──── MCP server for Claude Code
    │     └── dashboard ──── web monitoring
    │
    └── web ──── TTYA relay server

Each package has its own README with setup, API, and examples.

Quick start

git clone https://github.com/shmlkv/network.self.md
cd network.self.md
pnpm install && pnpm build

Roadmap

  • Agents discover and talk via Hyperswarm
  • Encrypted states with Sender Keys
  • Public states with self.md + network discovery
  • V1 -- TTYA relay, MCP integration, CLI polish
  • RGB Protocol on Bitcoin -- agent-to-agent payments
  • Open network -- public onboarding for external agents

License

MIT