_ _ _ _ _ _ (` ). _ (` ). _ (` ). _ (` ). _ (` ). _ (` ). _ ( ). .:(` )`. ( ). .:(` )`. ( ). .:(` )`. ( ). .:(` )`. ( ). .:(` )`. ( ). .:(` )`. ) _( '`. :( . ) _( '`. :( . ) _( '`. :( . ) _( '`. :( . ) _( '`. :( . ) _( '`. :( . ) .=(`( . ) .-- `. ( ) ) .=(`( . ) .-- `. ( ) ) .=(`( . ) .-- `. ( ) ) .=(`( . ) .-- `. ( ) ) .=(`( . ) .-- `. ( ) ) .=(`( . ) .-- `. ( ) ) (( (..__.:'-' .+( ) ` _` ) ) (( (..__.:'-' .+( ) ` _` ) ) (( (..__.:'-' .+( ) ` _` ) ) (( (..__.:'-' .+( ) ` _` ) ) (( (..__.:'-' .+( ) ` _` ) ) (( (..__.:'-' .+( ) ` _` ) ) `. `( ) ) ( . ) ( ) ._ `( ) ) ( . ) ( ) ._ `( ) ) ( . ) ( ) ._ `( ) ) ( . ) ( ) ._ `( ) ) ( . ) ( ) ._ `( ) ) ( . ) ( ) ._ ) ` __.:' ) ( ( )) `-'.-(` ) ` __.:' ) ( ( )) `-'.-(` ) ` __.:' ) ( ( )) `-'.-(` ) ` __.:' ) ( ( )) `-'.-(` ) ` __.:' ) ( ( )) `-'.-(` ) ` __.:' ) ( ( )) `-'.-(` ) ) ) ( ) --' `- __.' :( )) ( ) --' `- __.' :( )) ( ) --' `- __.' :( )) ( ) --' `- __.' :( )) ( ) --' `- __.' :( )) ( ) --' `- __.' :( )) .-' (_.' .') `( ) )) (_.' .') `( ) )) (_.' .') `( ) )) (_.' .') `( ) )) (_.' .') `( ) )) (_.' .') `( ) )) (_ ) ` __.:' (_ ) ` __.:' (_ ) ` __.:' (_ ) ` __.:' (_ ) ` __.:' (_ ) ` __.:' 
Radicle enables users to run their own nodes, ensuring censorship-resistant code collaboration and fostering a resilient network without reliance on third-parties.
All social artifacts are stored in git, and signed using public-key cryptography. Radicle verifies the authenticity and authorship of all data automatically.
Radicle is local-first, providing always-available functionality even without internet access. Users own their data, making migration, backup, and access easy both online and offline.
┌╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┐
┆ Radicle CLI ┆
└╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┘
┌╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┐
┆ Radicle Repository ┆
┆ ┌────────┐ ┌────────┐ ┌─────────┐ ┆
┆ │ code │ │ issues │ │ patches │ ┆
┆ └────────┘ └────────┘ └─────────┘ ┆
├╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┤
┆ Radicle Storage ┆
└╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┘
┌╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┐
┆ Radicle Node ┆
┆ ┌────────────┐ ┌─────────────────┐┆
┆ │ Git Daemon │ │ Gossip protocol │┆
┆ └────────────┘ └─────────────────┘┆
└╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┘
Radicle functions as a peer-to-peer protocol where each user on the network runs identical software, known as the Radicle Stack. This stack primarily consists of a command line interface and a networked service called the Radicle Node.
Nodes exchange data through a gossip protocol, forming a resilient, disruption-tolerant network.
Users can also opt to run the Radicle Web client and HTTP daemon, providing a familiar web-based experience for enhanced accessibility and convenience.
The Radicle CLI is an offline-first command line interface for Radicle. It provides a suite of tools to interact with your local Radicle state, including commands for managing issues, patches, and repositories, as well as user identities and profiles.
With the Radicle CLI, users can clone, checkout, and push repositories to the network, manage patches and issues, and control and query their Radicle Node.
$ rad init
Initializing radicle 👾 project in .
✓ Name: heartwood
✓ Description: Radicle Heartwood Protocol & Stack
✓ Project heartwood created
Your project id is rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji.
Show it at all times with:
rad .
To publish your project to the network, run:
git push rad
┌╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┐ ┌╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┐
┆┌─────────────────┐ ┌──────┐┆ ┆┌──────┐ ┌───────────────┐ ┆
┆│Storage │ │ │┆ Git ┆│ │ │Storage │ ┆
┆│ ├╸┆╸╸╸╸╸╸┆╸╸╸╸╸╸╸╸╸╸╸╸┆╸╸╸╸╸╸┆╸┤ │ ┆
┆│┌──────┐┌─────┐ ┌│ │ │┆ protocol ┆│ │ │┌─────┐┌─────┐ │ ┆
┆││repo ││repo │ ││ │ │┆ ┆│ │ ││repo ││repo │ │ ┆
┆│├──────┤├─────┤ ├│ │ │┆ ┆│ │ │├─────┤├─────┤ │ ┆
┆└┴───╿──┴┴───┬─┴─┴┘ │ │┆ ┆│ │ └┴───┬─┴┴───╿─┴─┘ ┆
┆ │ │ │ │┆ gossip ┆│ │ │ │ ┆
┆ │ │ │ Node ├╸╸╸╸╸╸╸╸╸╸╸╸┤ Node │ │ │ ┆
┆ │ │ │ │┆ protocol ┆│ │ │ │ ┆
┆ push pull │ │┆ ┆│ │ pull push ┆
┆ │ │ │ │┆ ┆│ │ │ │ ┆
┆ │ │ │ │┆ ┆│ │ │ │ ┆
┆ │ │ │ │┆ ┆│ │ │ │ ┆
┆┌────┴───┐┌──╽─────┐│ │┆ ┆│ │┌─────╽──┐┌──┴────┐┆
┆│working ││working ││ │┆ ┆│ ││working ││working│┆
┆│copy ││copy ││ │┆ ┆│ ││copy ││copy │┆
┆└────────┘└────────┘└──────┘┆ ┆└──────┘└────────┘└───────┘┆
└╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┘ └╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴┘
The Radicle network protocol focuses on locating, replicating, and verifying repositories in a peer-to-peer code hosting network. Its decentralized approach guarantees access to repositories, regardless of their location or replica count.
At the heart of Radicle is a gossip-based protocol for metadata exchange between nodes, which are identified by public keys. Nodes gossip repository information to build routing tables that aid in repository discovery and replication.
By leveraging Git, Radicle enables efficient data transfer and offers compatibility with existing workflows.
The Radicle Network is a peer-to-peer network that replicates code, issues and patches over the internet to create a resilient code collaboration system.
Radicle uses the Git protocol for data replication and its own gossip protocol to exchange peer and repository information between nodes.
Peer connections are established using the Noise protocol, which allows for secure, encrypted communications within the network.
o o
\ /
o o o o o o
\ / | / \ /
o o - o o - o
| / \ / /
o - o o - o - o - o
\ / \ / \ \
o - o o o o o
/ \ \ \ /
o o - o o o - o
/
o
You can install Radicle by running the following command in your
terminal.
Radicle is currently supported on Linux and macOS.
\|/ --o-- /|\ * _ _ =(_. -(__ .) _(_ __) . (_` _)`-. . =( ` _) ) * (_( ` ' ) ~.`._ ~__ _ .__ __'_- ..-.--*--.__-__..._.--..-._.---....~__..._.--..~._.---.--..____.--_--'`_---..
-.--~--._ __..._.--..~._.--- - -.____.--_--'`_---..~.----_~