{"id":13510074,"url":"https://github.com/radicle-dev/radicle-alpha","last_synced_at":"2025-03-30T15:30:37.611Z","repository":{"id":66503389,"uuid":"133785846","full_name":"radicle-dev/radicle-alpha","owner":"radicle-dev","description":"A peer-to-peer stack for code collaboration","archived":true,"fork":false,"pushed_at":"2020-03-26T14:58:12.000Z","size":2568,"stargazers_count":912,"open_issues_count":45,"forks_count":33,"subscribers_count":28,"default_branch":"master","last_synced_at":"2024-11-01T10:35:11.938Z","etag":null,"topics":["code","decentralized","developer-tools","p2p"],"latest_commit_sha":null,"homepage":"https://radicle.xyz","language":"Haskell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/radicle-dev.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-05-17T08:50:33.000Z","updated_at":"2024-07-29T08:55:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"45d8ac2b-a45c-48b9-8b36-cb6be6c9e635","html_url":"https://github.com/radicle-dev/radicle-alpha","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicle-dev%2Fradicle-alpha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicle-dev%2Fradicle-alpha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicle-dev%2Fradicle-alpha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicle-dev%2Fradicle-alpha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/radicle-dev","download_url":"https://codeload.github.com/radicle-dev/radicle-alpha/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246338596,"owners_count":20761406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code","decentralized","developer-tools","p2p"],"created_at":"2024-08-01T02:01:23.147Z","updated_at":"2025-03-30T15:30:32.598Z","avatar_url":"https://github.com/radicle-dev.png","language":"Haskell","readme":"## :rotating_light: THIS PROJECT IS NOT ACTIVELY MAINTAINED :rotating_light:\n\nWe are still developing Radicle, the main repositories are:\n\n* https://github.com/radicle-dev/radicle-link\n* https://github.com/radicle-dev/radicle-registry\n* https://github.com/radicle-dev/radicle-upstream\n\nJoin us on [discourse](https://radicle.community) for updates, and if you want\nto get involved!\n\n---\n\n# Radicle\n\nA peer-to-peer stack for code collaboration.\n\n- **peer-to-peer** : The Radicle stack builds on IPFS, and works without a centralized server. No hassle with setting up your own hosting, and no need to trust companies with your data.\n- **terminal-first** : A Radicle project contains a git repository, plus the associated issues and proposals. Access all the issues and proposals associated with your codebase right from your terminal.\n- **programmable** : Ever wanted to tweak your code collaboration service? With Radicle each unit of functionality –a machine– is its own litte P2P program, written in the Radicle language. You can change them to suit your needs, or create entirely new ones.\n\n\nRadicle has a [webpage](https://radicle.xyz/) which contains a lot more information on `Radicle`.\n\n## Installation\n\nTo build Radicle from source you will need [`stack`][stack].\n\nAnd make sure the location at which stack installs executables is in your\n`PATH`: `export PATH=$HOME/.local/bin:$PATH`.\n\n```\nstack build\nstack install :rad :radicle\n```\n\nNote: `stack` will need about 4GB of memory to compile successfully.\n\nTo use Radicle you will also need to install [`ipfs`][ipfs] and\n[`git-remote-ipfs`][git-remote-ipfs]. Running Radicle requires you to keep both the\nRadicle daemon and Radicle IPFS daemon running.\n\n```\nrad daemon-ipfs\nrad daemon-radicle\n```\n\n[stack]: https://docs.haskellstack.org/en/stable/install_and_upgrade/\n[ipfs]: https://docs.ipfs.io/guides/guides/install/\n[git-remote-ipfs]: https://github.com/oscoin/ipfs/tree/master/git-remote-ipfs#install\n\n### Debian/Ubuntu\n\nWe provide `.deb` packages for Debian-based systems.\n\n    wget https://storage.googleapis.com/static.radicle.xyz/releases/radicle_latest_amd64.deb\n    sudo apt install ./radicle_latest_amd64.deb\n\nTo use Radicle you need to start the Radicle daemon\n\n    systemctl --user start radicle-daemon\n    systemctl --user status radicle-daemon\n\n## Issues\n\nWe are currently using `Radicle` itself to manage issues (but you\ncan still submit issues on Github). You can create and see issues with `rad issues list`\nin the project repo. To checkout the project, run:\n\n```\nrad project checkout 12D3KooWPS3UXcvSZSXfi7P4J9Ut8MMVNvN63HHiCSP8rxj3RmtC\n```\n\nIf you cloned the project from Github, you can instead, from the repo, run:\n\n```\ngit config radicle.project-id 12D3KooWPS3UXcvSZSXfi7P4J9Ut8MMVNvN63HHiCSP8rxj3RmtC\n```\n\nYou can also reach us on the `radicle` IRC channel on `#freenode`, or via the\n[mailing list](https://groups.google.com/a/monadic.xyz/forum/#!forum/radicle).\n\n\n## Development\n\nThe script `./scripts/ci-tests.sh` runs all tests that are run on CI. The script\nrequires [`docker`][docker] and [`docker-compose`][docker-compose] to be\ninstalled for end-to-end tests.\n\nThe documentation is build with `make -C docs html`. Reference documentation for\nRadicle code must be regenerated with `stack run radicle-doc-ref` and checked\ninto version control.\n\n### End-to-end Tests\n\nThe end-to-end test suite is run with\n\n    RAD_IPFS_API_URL=http://localhost:19301 \\\n      RAD_BIN=\"$(stack path --docker --local-install-root)/bin\" stack test :e2e\n\nIt requires you to first start up an IPFS test network and the Radicle daemon.\n\n    docker-compose -f test/docker-compose.yaml up -d ipfs-test-network\n    RAD_IPFS_API_URL=http://localhost:19301 stack exec -- \\\n      rad-daemon-radicle --machine-config /tmp/radicle-machines.json\n\nAnd to build the project with stack's docker support:\n\n    stack build --docker\n\nIf you use `docker-compose up` for the first time you will also need to\ninitialize the IPFS test network with\n\n    echo '{\"radicle\": true}' | \\\n      docker-compose -f test/docker-compose.yaml exec -T ipfs-test-network ipfs dag put\n\nIf you are using `docker-machine`, replace `localhost` in `RAD_IPFS_API_URL`\nwith the output of `docker-machine ip`.\n\nYou can reset the test daemon’s machine configuration by removing the file\n`/tmp/radicle-machines.json`.\n\n### Packaging\n\nPackages can be built with the `./packaging/build-package.sh` script. Run it\nwith `-h` for more information. The script requires [`fpm`][fpm].\n\nOn CI a Debian package is built for every commit and uploaded to\n`http://static.radicle.xyz/releases`. The package uses the commit hash as the\nversion.\n\n[fpm]: https://github.com/jordansissel/fpm\n\n### Troubleshooting\n\nYour local machine might build binaries that are incompatible with the\n`debian:stretch` container image. In that case building the docker images fails.\nYou can build compatible binaries using stack’s [docker\nintegration][stack-docker-integration]. This is enabled by passing the\n`STACK_DOCKER=1` environment to `./scripts/ci-tests.sh`.\n\n\n[stack-docker-integration]: https://docs.haskellstack.org/en/stable/docker_integration/\n[docker]: https://www.docker.com/get-started\n[docker-compose]: https://docs.docker.com/compose/install\n\n\n## Code of conduct\n\nPlease read our [code of conduct](code-of-conduct.md) when thinking of contributing.\n","funding_links":[],"categories":["p2p","Haskell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradicle-dev%2Fradicle-alpha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fradicle-dev%2Fradicle-alpha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradicle-dev%2Fradicle-alpha/lists"}