Hypermind-Swarm is a peer-to-peer, Twitter-style social platform built for decentralized and ephemeral conversations. It's a fork of the original Hypermind project, evolving from a simple deployment counter into a full-fledged communication swarm.
Built by the same creator, Hypermind-Swarm leverages the same robust P2P architecture to give you a place to be yourself—free from algorithms, central servers, and permanent digital footprints.
We're bringing back the care-free spirit of the early internet. No engagement metrics to chase, no shadow-banning algorithms, and no "permanent records." Just people talking to people in real-time.
- No Algorithms: You see what's happening in the swarm as it happens.
- No Servers: Your data lives in the mesh, not on a corporate rack.
- No History: Conversations are ephemeral. When the swarm moves on, so does the data.
To keep things simple, we've redefined how you interact with the swarm:
- Swarms: These are your topics or "channels." Join a swarm to see what people are talking about in that specific niche.
- Pings: These are your messages (tweets). Short, sweet, and broadcast to everyone in your current swarm.
- Amplify: Like what you see? Amplify it. It's our version of a like or retweet, helping pings travel further through the mesh.
Hypermind Swarm utilizes the Hyperswarm DHT (Distributed Hash Table) to create a resilient, serverless mesh network.
- Discovery: Your node uses the DHT to find other peers interested in the same Swarms.
- Gossip: Pings and Amplifications are gossiped across the network, ensuring everyone stays in sync without a central authority.
- Identity: Uses cryptographic keypairs for identity. You own your "handle," and your messages are signed and verified by the swarm.
- Ephemeral State: We use a distributed LRU cache and probabilistic data structures (like HyperLogLog) to manage peer counts and message flow without a database.
Join any topic and immediately start seeing pings from peers around the world.
- Global Reach: Messages relay through multiple hops to reach the entire swarm.
- Topic-Based: Easily switch between different swarms to follow different conversations.
- Pings: Send text updates to your current swarm.
- Amplify: Boost pings you find interesting to help them reach more peers.
- Anonymous by Default: A unique 90's style username generator ensures everyone remains anonymous while bringing back some whimsy to the internet.
- Serverless: No central point of failure or data collection.
- Ephemeral: Messages aren't stored forever. The swarm is for the now.
- Incognito: Generate a new identity whenever you want.
The main swarm feed - unfiltered and real-time.
Your decentralized identity and swarm subscriptions.
Open http://localhost:3000 to access your local node's dashboard. The UI updates in real-time via Server-Sent Events (SSE) as pings arrive from the swarm.
# Install dependencies
npm install
# Start your node
npm startDeployment (Docker)
docker run -d \
--name hypermind-swarm \
--network host \
--restart unless-stopped \
-e PORT=3000 \
-e WEB_AUTH=admin:change-me \
ghcr.io/lklynet/hypermind-swarm:latest
⚠️ NETWORK NOTE: Always use--network host. As a P2P application, Hypermind Swarm needs direct access to network interfaces to punch through NATs and find peers effectively.
Environment Variables
| Variable | Default | Description |
|---|---|---|
PORT |
3000 |
The web dashboard port. |
MAX_PEERS |
50000 |
Max peers to track in the swarm. |
MAX_CONNECTIONS |
50 |
Max active P2P connections. |
MAX_RELAY_HOPS |
10 |
How far a ping travels through the mesh. |
DEVICE_PERSISTENCE |
false |
Enable deterministic identity based on device MAC address. |
WEB_AUTH |
`` | Optional dashboard auth in format username:password. |
Hypermind Swarm is an open experiment in decentralized social networking. If you want to help make the internet fun again, feel free to open a PR or join a swarm and say hello!
Built with 🍺 on the Hyperswarm stack.