Skip to content

kh0pper/crow

Repository files navigation

Crow

AI-powered project management, persistent memory, encrypted P2P sharing, and 20+ integrations for your AI assistant. Built on the open Model Context Protocol standard.

Published by Maestro Press | Product Page

Share memories, projects, and messages directly between Crow users — end-to-end encrypted, no central server, no accounts. The first AI platform where your assistant can securely collaborate with other people's assistants.

┌───────────────────────────────────────────────────────────────────────┐
│       AI Client (Claude, ChatGPT, Gemini, Grok, Cursor, etc.)       │
└────────┬──────────────────────┬──────────────────────┬───────────────┘
         │                      │                      │
   /memory/mcp            /projects/mcp          /tools/mcp
   /sharing/mcp           /storage/mcp           /blog-mcp/mcp
   /sharing/sse           /relay/*
         │                      │                      │
┌────────┴──────────────────────┴──────────────────────┴───────────────┐
│  Crow Gateway (Express + OAuth 2.1)                                  │
│  ├── crow-memory (persistent memory + full-text search)              │
│  ├── crow-projects (project management + APA citations + data backends) │
│  ├── crow-sharing (P2P encrypted sharing + Nostr messaging)          │
│  ├── crow-storage (S3-compatible file storage + quotas)              │
│  ├── crow-blog (publishing platform + RSS/Atom feeds)                │
│  └── proxy → GitHub, Slack, Notion, Gmail, Trello, Discord, etc.     │
└──────────────────────────────┬───────────────────────────────────────┘
                               │
                      ┌────────┴────────┐
                      │     SQLite       │
                      │ (local or Turso) │
                      └─────────────────┘

## P2P Sharing — A First for AI Platforms

Crow is the first AI platform with built-in encrypted peer-to-peer sharing. No cloud middleman, no accounts to create — just your Crow ID.

- **Share memories and projects** — Send a memory or an entire project to a friend's Crow, encrypted end-to-end
- **Collaborate on projects** — Grant read or read-write access to projects that stay in sync automatically
- **Encrypted messaging** — Send messages between Crow users via the Nostr protocol with full sender anonymity
- **Works offline** — Shares queue up and deliver when both peers are online. Peer relays handle async delivery.
- **Zero trust** — No central server sees your data. Invite codes, safety numbers, and NaCl encryption throughout.

> *"Share my project with Alice, read-write"* — that's it. Crow handles the cryptography, discovery, and sync.

Learn more: **[Sharing Guide](https://maestro.press/software/crow/guide/sharing)** · **[Architecture](https://maestro.press/software/crow/architecture/sharing-server)**

## Crow's Nest

Server-rendered web UI with Dark Editorial design. Password-protected, session-based auth. Built-in panels for Messages, Blog, Files, Extensions, and Settings. Third-party panels can be installed from `~/.crow/panels/`.

> **[Crow's Nest Guide](https://maestro.press/software/crow/guide/crows-nest)** · **[Architecture](https://maestro.press/software/crow/architecture/dashboard)**

## Blog Platform

Create, edit, and publish blog posts through your AI assistant. Markdown rendering, customizable themes, RSS/Atom feeds, and shareable public URLs via the gateway.

> **[Blog Guide](https://maestro.press/software/crow/guide/blog)** · **[Architecture](https://maestro.press/software/crow/architecture/blog-server)**

## Works With

| Claude | ChatGPT | Gemini | Grok | Cursor | Windsurf | Cline | Claude Code |
|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| Web, Mobile, Desktop | Apps/Connectors | CLI, AI Studio | Remote MCP | IDE | IDE | VS Code | CLI |

## Quick Start

### Managed Hosting (Easiest)

Pre-configured Crow instance at `username.crow.maestro.press` — no setup, no maintenance. $15/mo or $120/yr.

> **[Get managed hosting →](https://maestro.press/hosting/)**

### Oracle Cloud Free Tier (Recommended Free)

A permanent free server that never sleeps — local SQLite, no external database needed.

1. Create a free [Oracle Cloud](https://cloud.oracle.com) account
2. Launch an Always Free VM.Standard.E2.1.Micro instance (Ubuntu 22.04)
3. Install Crow + Tailscale, create a systemd service
4. Connect from any AI platform

→ **[Full Oracle Cloud guide](https://maestro.press/software/crow/getting-started/oracle-cloud)**

### Desktop (Claude Desktop)

```bash
git clone https://github.com/kh0pper/crow.git && cd crow
npm run setup
npm run desktop-config  # Copy output to Claude Desktop config

Desktop setup guide

Developer (Claude Code)

cd crow
npm run setup
claude  # Loads .mcp.json + CLAUDE.md automatically

Claude Code guide

Raspberry Pi / Self-Hosted (Crow OS)

curl -fsSL https://raw.githubusercontent.com/kh0pper/crow/main/scripts/crow-install.sh | bash
crow status

Installs Crow as a persistent service with the crow CLI for managing bundles and updates. Supports Raspberry Pi, Debian, and Ubuntu.

Full setup guide

Crow OS & Self-Hosting

Crow OS turns a Raspberry Pi or any Debian machine into a personal AI server. The crow CLI manages the platform and installable add-on bundles:

  • crow status — Platform health, identity, and resource usage
  • crow bundle install <id> — Install add-ons like Ollama, Nextcloud, or Immich
  • crow bundle start/stop/remove — Lifecycle management for bundle containers

Self-hosting add-ons include local AI (Ollama), file sync (Nextcloud), photo management (Immich), smart home (Home Assistant), and knowledge management (Obsidian).

Crow OS Installer · Add-on Registry

Developer Program

Crow is open to contributions! Build integrations, skills, tools, and deployment bundles for the ecosystem.

  • MCP Integrations — Connect new services (Linear, Jira, Todoist, etc.)
  • Skills — Write behavioral prompts that teach the AI new workflows (no code required)
  • Core Tools — Add MCP tools to crow-memory, crow-projects, crow-sharing, crow-storage, or crow-blog
  • Self-Hosted Bundles — Create Docker Compose configs for specific use cases

Developer Docs · Community Directory · CONTRIBUTING.md

Documentation

Full documentation at maestro.press/software/crow

  • Managed Hosting — Pre-configured Crow instance, no setup required
  • Maestro Press Product Page — Overview, vision, and quick start
  • Platform Guides — Setup for Claude, ChatGPT, Gemini, Grok, Cursor, Windsurf, Cline
  • Integrations — All 20+ services with API key setup instructions
  • Sharing & Social — P2P encrypted sharing, messaging, and collaboration
  • Storage — S3-compatible file storage with quotas and presigned URLs
  • Blog — AI-driven publishing with themes, RSS, and public sharing
  • Crow's Nest — Web UI with panels for messages, files, blog, and extensions
  • Architecture — System design, server APIs, gateway details
  • Skills — 30 behavioral prompts for AI workflows
  • Security — API key safety, deployment security, and what to do if a key leaks
  • Troubleshooting

License

MIT

About

Open-source MCP AI platform: persistent memory, research pipeline, encrypted P2P sharing. Works with Claude, ChatGPT, Gemini, Grok, Cursor, Windsurf, Cline, and Claude Code.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages