mirror of
https://seed.radicle.dev/rad:z371PVmDHdjJucejRoRYJcDEvD5pp.git
synced 2026-10-18 19:10:34 +08:00
Co-authored-by: Lorenz Leutgeb <lorenz.leutgeb@radicle.dev> Co-authored-by: Rūdolfs Ošiņš <rudolfs@osins.org> Co-authored-by: Yorgos Saslis <yorgos.work@proton.me>
176 lines
8.2 KiB
Markdown
176 lines
8.2 KiB
Markdown
---
|
|
title: "Radicle: the sovereign forge"
|
|
layout: index
|
|
preconnect:
|
|
- https://files.radicle.dev
|
|
scripts:
|
|
- copy
|
|
- latest-release
|
|
---
|
|
|
|
# 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, as well as Windows.
|
|
|
|
<a class="button" href="{% link _guides/quick-start.md %}">Get started →</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 →</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.09.2026 [Disclosure of Vulnerability in the Network Protocol]({% post_url 2026-09-23-disclosure-of-vulnerability-in-network-protocol %}). 🔐
|
|
- 08.09.2026 [Radicle 1.10.3]({% post_url 2026-09-08-radicle-1.10.3 %}) released. ✨
|
|
- 26.08.2026 [Radicle 1.10.2]({% post_url 2026-08-26-radicle-1.10.2 %}) released.
|
|
- 12.08.2026 [Radicle 1.10.1]({% post_url 2026-08-12-radicle-1.10.1 %}) released.
|
|
- 05.08.2026 [Radicle 1.10.0]({% post_url 2026-08-05-radicle-1.10.0 %}) released.
|
|
- 22.05.2026 [Radicle 1.9.1]({% post_url 2026-05-22-radicle-1.9.1 %}) released.
|
|
- 19.05.2026 [Radicle 1.9.0]({% post_url 2026-05-19-radicle-1.9.0 %}) released.
|
|
- 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
|
|
|
|
- 02.06.2026 [Plant your Seeds in the Radicle Garden]({% post_url 2026-06-02-announcing-radicle-garden %}) 🌱
|
|
- 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
|