Radish alpha
r
rad:z371PVmDHdjJucejRoRYJcDEvD5pp
Radicle website including documentation and guides
Radicle
Git
radicle.xyz β€Ί index.md

Synopsis

Radicle is an open source, peer-to-peer code collaboration stack built on Git. Unlike centralized code hosting platforms, there is no single entity controlling the network. Repositories are replicated across peers in a decentralized manner, and users are in full control of their data and workflow.

The Radicle heartwood repository. Repository ID rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5.

Get started

{% include latest-release.html %}

To install Radicle, simply run the command below from your shell, or go to the [download] page.

{% include install.html %}

Alternatively, you can build from [source][heartwood].

For now, Radicle only works on Linux, macOS and BSD variants.

Follow the guide β†’

Radicle Desktop πŸ–₯️

For a graphical collaborative experience check out the [Radicle Desktop client][desktop], as well.

How it works

The Radicle protocol leverages cryptographic identities for code and social artifacts, utilizes Git for efficient data transfer between peers, and employs a custom gossip protocol for exchanging repository metadata.

Learn more β†’

Your Data, Forever and Secure

All social artifacts are stored in Git, and signed using public-key cryptography. Radicle verifies the authenticity and authorship of all data for you.

Unparalleled Autonomy

Radicle enables users to run their own nodes, ensuring censorship-resistant code collaboration and fostering a resilient network without reliance on third-parties.

Local-first

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.

Evolvable & Extensible

Radicle’s [Collaborative Objects][cobs] (COBs) provide Radicle’s social primitive. This enables features such as issues, discussions and code review to be implemented as Git objects. Developers can extend Radicle’s capabilities to build any kind of collaboration flow they see fit.

Modular by Design

The Radicle Stack comes with a CLI, web interface and TUI, that are backed by the Radicle Node and HTTP Daemon. It’s modular, so any part can be swapped out and other clients can be developed.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Radicle CLI    β”‚β”‚ Radicle Web    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Radicle Repository               β”‚
β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚ β”‚  code  β”‚ β”‚ issues β”‚ β”‚ patches β”‚ β”‚
β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  Radicle Storage (Git)            β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Radicle Node  β”‚β”‚  Radicle HTTPD  β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚    NoiseXK     β”‚β”‚   HTTP + JSON   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Browse our repositories β†—

Contributing

Radicle is free and open source software under the MIT and Apache 2.0 licenses. Get involved by [contributing code][contribute].

[contribute]: {{ β€œrad:z3gqcJUoA1n9HaHKufZs5FCSGazv5/tree/CONTRIBUTING.md” | explore }}

Updates

Follow us on 🐘 [Mastodon][mast], πŸ¦‹ [Bluesky][bsky] or 🐦 Twitter to stay updated, join our community on πŸ’¬ [Zulip][zulip], or Subscribe RSS logo

  • 23.04.2026 [We have moved to radicle.{dev,network}!]({% post_url 2026-04-23-domain-move %}) 🌐
  • 30.03.2026 [Radicle 1.8.0]({% post_url 2026-03-30-radicle-1.8.0 %}) released. ✨
  • 30.03.2026 [Disclosure of Vulnerability in Signed References]({% post_url 2026-03-30-disclosure-of-vulnerability-in-signed-references %}). πŸ”
  • 20.03.2026 [Radicle 1.7.1]({% post_url 2026-03-20-radicle-1.7.1 %}) released. πŸ› οΈ
  • 18.03.2026 [Radicle 1.7.0]({% post_url 2026-03-18-radicle-1.7.0 %}) released. 🌀️
  • 14.01.2026 [Radicle 1.6.0]({% post_url 2026-01-14-radicle-1.6.0 %}) released.
  • 30.09.2025 [Radicle 1.5.0]({% post_url 2025-09-30-radicle-1.5.0 %}) released.
  • 04.09.2025 [Radicle 1.4.0]({% post_url 2025-09-04-radicle-1.4.0 %}) released.
  • 12.08.2025 [Radicle 1.3.0]({% post_url 2025-08-12-radicle-1.3.0 %}) released.
  • 17.07.2025 [Radicle 1.2.1]({% post_url 2025-07-17-radicle-1.2.1 %}) released.
  • 13.06.2025 [Radicle Desktop]({% post_url 2025-06-13-radicle-desktop %}) is out. πŸ–₯️
  • 02.06.2025 [Radicle 1.2.0]({% post_url 2025-06-02-radicle-1.2.0 %}) released.
  • 05.12.2024 [Radicle 1.1.0]({% post_url 2024-12-05-radicle-1.1.0 %}) released.
  • 10.09.2024 [Radicle 1.0.0]({% post_url 2024-09-10-radicle-1.0.0 %}) released.
  • 26.03.2024 Radicle 1.0.0-rc.1 released.
  • 10.03.2024 New Radicle homepage.
  • 05.03.2024 [Radicle Guides]({% link _pages/guides.md %}) launch.
  • 05.03.2024 Radicle makes it to the top of Hacker News!
  • 18.04.2023 Radicle heartwood is announced.

Blog

  • 14.08.2025 [Jujutsu + Radicle = ❀️]({% post_url 2025-08-14-jujutsu-with-radicle %})
  • 12.08.2025 [Canonical References]({% post_url 2025-08-12-canonical-references %})
  • 23.07.2025 [Using Radicle CI for Development]({% post_url 2025-07-23-using-radicle-ci-for-development %})
  • 30.05.2025 [How we used Radicle with GitHub Actions]({% post_url 2025-05-30-radicle-with-github-actions %})

Feedback

If you have feedback, join our [Zulip][zulip] or send us an email at feedback@radicle.dev. Emails sent to this address are automatically posted to our #feedback channel on Zulip.

[bsky]: https://bsky.app/profile/{{ site.atproto }} [mast]: {{ site.fedi | fedi_to_https }} [zulip]: https://radicle.zulipchat.com [heartwood]: {{ β€œrad:z3gqcJUoA1n9HaHKufZs5FCSGazv5” | explore }} [desktop]: /desktop [cobs]: /guides/protocol#collaborative-objects [local-first]: https://www.inkandswitch.com/local-first/ [download]: /download

---
title: "Radicle: the sovereign forge"
layout: index
---

# Synopsis

Radicle is an open source, peer-to-peer code collaboration stack built on Git.
Unlike centralized code hosting platforms, there is no single entity
controlling the network. Repositories are replicated across peers in a
decentralized manner, and users are in full control of their data and workflow.

<a class="screenshot" href="{{ 'rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5' | explore }}" target="_blank" title="Heartwood is the latest generation of the Radicle protocol">
  <img class="screenshot" src="/assets/images/web-app-screenshot.png"/>
</a>
<small class="caption">
  The Radicle <code>heartwood</code> repository. Repository ID
  <code>rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5</code>.
</small>

<a id="get-started"><!-- Anchor --></a>

# Get started

{% include latest-release.html %}

To install Radicle, simply run the command below from your shell, or go to the
[download] page.

{% include install.html %}

Alternatively, you can build from [source][heartwood].

For now, Radicle only works on Linux, macOS and BSD variants.

<a class="button" href="{% link _guides/user.md %}">Follow the guide &rarr;</a>

## Radicle Desktop πŸ–₯️

For a graphical collaborative experience check out the [Radicle Desktop client][desktop], as well.

# How it works

The Radicle protocol leverages cryptographic identities for code and social
artifacts, utilizes Git for efficient data transfer between peers, and employs
a custom gossip protocol for exchanging repository metadata.

<a class="button" href="{% link _guides/protocol.md %}">Learn more &rarr;</a>

## Your Data, Forever and Secure

All social artifacts are stored in Git, and signed using public-key
cryptography. Radicle verifies the authenticity and authorship of all data
for you.

## Unparalleled Autonomy

Radicle enables users to run their own nodes, ensuring censorship-resistant
code collaboration and fostering a resilient network without reliance on
third-parties.

## Local-first

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.

## Evolvable & Extensible

Radicle's [Collaborative Objects][cobs] (COBs) provide Radicle's *social
primitive*. This enables features such as issues, discussions and code review
to be implemented as Git objects. Developers can extend Radicle's capabilities
to build any kind of collaboration flow they see fit.

## Modular by Design

The Radicle Stack comes with a CLI, web interface and TUI, that are backed by
the Radicle Node and HTTP Daemon. It's modular, so any part can be swapped out
and other clients can be developed.

<pre class="diagram">
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Radicle CLI    β”‚β”‚ Radicle Web    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Radicle Repository               β”‚
β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚ β”‚  code  β”‚ β”‚ issues β”‚ β”‚ patches β”‚ β”‚
β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  Radicle Storage (Git)            β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Radicle Node  β”‚β”‚  Radicle HTTPD  β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚    NoiseXK     β”‚β”‚   HTTP + JSON   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
</pre>

<a class="button" href="{{ '' | explore }}">Browse our repositories β†—</a>

# Contributing

Radicle is *free and open source* software under the MIT and Apache 2.0
licenses. Get involved by [contributing code][contribute].

[contribute]: {{ "rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5/tree/CONTRIBUTING.md" | explore }}

# Updates

**Follow us** on 🐘 [Mastodon][mast], πŸ¦‹ [Bluesky][bsky] or 🐦 [Twitter][twitter] to stay
updated, join our community on πŸ’¬ [Zulip][zulip], or <a href="{{ site.feed.path | default: '/feed.xml' | relative_url }}">
  Subscribe <img src="/assets/images/rss.svg" alt="RSS logo" style="width:15px;"/>
</a>

- 23.04.2026 [We have moved to radicle.{dev,network}!]({% post_url 2026-04-23-domain-move %}) 🌐
- 30.03.2026 [Radicle 1.8.0]({% post_url 2026-03-30-radicle-1.8.0 %}) released. ✨
- 30.03.2026 [Disclosure of Vulnerability in Signed References]({% post_url 2026-03-30-disclosure-of-vulnerability-in-signed-references %}). πŸ”
- 20.03.2026 [Radicle 1.7.1]({% post_url 2026-03-20-radicle-1.7.1 %}) released. πŸ› οΈ
- 18.03.2026 [Radicle 1.7.0]({% post_url 2026-03-18-radicle-1.7.0 %}) released. 🌀️
- 14.01.2026 [Radicle 1.6.0]({% post_url 2026-01-14-radicle-1.6.0 %}) released.
- 30.09.2025 [Radicle 1.5.0]({% post_url 2025-09-30-radicle-1.5.0 %}) released.
- 04.09.2025 [Radicle 1.4.0]({% post_url 2025-09-04-radicle-1.4.0 %}) released.
- 12.08.2025 [Radicle 1.3.0]({% post_url 2025-08-12-radicle-1.3.0 %}) released.
- 17.07.2025 [Radicle 1.2.1]({% post_url 2025-07-17-radicle-1.2.1 %}) released.
- 13.06.2025 [Radicle Desktop]({% post_url 2025-06-13-radicle-desktop %}) is out. πŸ–₯️
- 02.06.2025 [Radicle 1.2.0]({% post_url 2025-06-02-radicle-1.2.0 %}) released.
- 05.12.2024 [Radicle 1.1.0]({% post_url 2024-12-05-radicle-1.1.0 %}) released.
- 10.09.2024 [Radicle 1.0.0]({% post_url 2024-09-10-radicle-1.0.0 %}) released.
- 26.03.2024 [Radicle 1.0.0-rc.1][1.0.0-rc.1] released.
- 10.03.2024 New Radicle homepage.
- 05.03.2024 [Radicle Guides]({% link _pages/guides.md %}) launch.
- 05.03.2024 [Radicle makes it to the top of Hacker News][hn]!
- 18.04.2023 [Radicle heartwood is announced](https://x.com/radicle/status/1648336186862194693?s=20).

[hn]: https://news.ycombinator.com/item?id=39600810
[1.0.0-rc.1]: https://twitter.com/radicle/status/1772659708978991605

## Blog

- 14.08.2025 [Jujutsu + Radicle = ❀️]({% post_url 2025-08-14-jujutsu-with-radicle %})
- 12.08.2025 [Canonical References]({% post_url 2025-08-12-canonical-references %})
- 23.07.2025 [Using Radicle CI for Development]({% post_url 2025-07-23-using-radicle-ci-for-development %})
- 30.05.2025 [How we used Radicle with GitHub Actions]({% post_url 2025-05-30-radicle-with-github-actions %})

# Feedback

If you have feedback, join our [Zulip][zulip] or send us an email at
[feedback@radicle.dev](mailto:feedback@radicle.dev). Emails sent to this
address are automatically posted to our [#feedback](https://radicle.zulipchat.com/#narrow/channel/392584-feedback)
channel on Zulip.

[install-script]: /install
[twitter]: https://twitter.com/radicle
[bsky]: https://bsky.app/profile/{{ site.atproto }}
[mast]: {{ site.fedi | fedi_to_https }}
[zulip]: https://radicle.zulipchat.com
[heartwood]: {{ "rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5" | explore }}
[desktop]: /desktop
[cobs]: /guides/protocol#collaborative-objects
[local-first]: https://www.inkandswitch.com/local-first/
[download]: /download