{"id":15158354,"url":"https://github.com/seed-hypermedia/seed","last_synced_at":"2026-04-02T12:10:16.722Z","repository":{"id":248019490,"uuid":"827507501","full_name":"seed-hypermedia/seed","owner":"seed-hypermedia","description":"Desktop+Web app for self-publishing, powered by the open Hypermedia protocol","archived":false,"fork":false,"pushed_at":"2026-01-08T18:38:47.000Z","size":75149,"stargazers_count":39,"open_issues_count":9,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-08T23:50:10.184Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://seed.hyper.media","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seed-hypermedia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2024-07-11T19:36:01.000Z","updated_at":"2026-01-08T18:38:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"ce28e928-bc96-4991-9dbd-d7e6ed2fedda","html_url":"https://github.com/seed-hypermedia/seed","commit_stats":null,"previous_names":["seed-hypermedia/seed"],"tags_count":240,"template":false,"template_full_name":null,"purl":"pkg:github/seed-hypermedia/seed","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seed-hypermedia%2Fseed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seed-hypermedia%2Fseed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seed-hypermedia%2Fseed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seed-hypermedia%2Fseed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seed-hypermedia","download_url":"https://codeload.github.com/seed-hypermedia/seed/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seed-hypermedia%2Fseed/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28487586,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T22:54:02.790Z","status":"ssl_error","status_checked_at":"2026-01-16T22:50:10.344Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-09-26T21:00:21.530Z","updated_at":"2026-02-12T11:17:36.211Z","avatar_url":"https://github.com/seed-hypermedia.png","language":"C","funding_links":[],"categories":["Apps"],"sub_categories":[],"readme":"# Seed\n\nSeed is a decentralized knowledge collaboration application for open\ncommunities powered by a knowledge graph.\n\nYou can read more about the product and why we are here on our website: https://seed.hyper.media.\n\n### Hypermedia Protocol\n\nSeed Hypermedia is powered by the new [Hypermedia Web Protocol](https://hyper.media). This\nopen protocol provides secure identities, version control, semantic documents, multimedia,\nand groups/organizations.\n\n### Desktop App + Web Server\n\nThis repo includes:\n\n1. Seed Desktop - app for writing, reading, and saving Hypermedia content\n2. Seed Hypermedia Web Server - public web experience, a read-only portal of the Hypermedia network\n\n## ⚠️ Stability\n\nThis is software is being actively developed, and may contain bugs and rough edges.\nWe appreciate any feedback and bug reports, so if you find any, please open an issue.\n\nThe permanent data format has been declared stable, and we don't expect any breaking changes there.\nDocumentation is still missing though, but it will come.\n\nWe still recommend you to have a copy of anything valuable you put into the app, while we are polishing it,\nand improving the overall stability.\n\n## Dev Environment\n\nSee the [developer setup](./docs/docs/dev-setup.md) page for detailed instructions.\n\nThe dev environment on macOS+Linux uses the [Mise](https://mise.jdx.dev),\nand [Direnv](https://direnv.net).\n\nThe bare minimum required for compilation is to have Go, and NodeJS toolchains\ninstalled.\n\n[./dev](./dev) is the main dev CLI. Run `./dev` to list commands, including:\n\n- `./dev run-desktop`\n- `./dev run-desktop-mainnet`\n- `./dev build-desktop`\n- `./dev run-site`\n- `./dev build-site`\n\nTo run the dev build with the production network, use the following command:\n\n```\nSEED_P2P_TESTNET_NAME=\"\" ./dev run-desktop\n```\n\n## Frontend Testing\n\n```bash\npnpm test               # test all the packages\npnpm desktop:test       # test desktop app (e2e only now)\npnpm site:test          # test only site code (WIP)\n```\n\n## Web Build\n\n## Group sites\n\nGroup sites need two programs to run. The daemon which includes the P2P node (go app)\nand the frontend that renders documents (nextjs app). However for a production\ndeployment everything is orchestrated by docker compose. Read next sections for how to\neither deploy a site on a production server or run it locally in dev mode\n\n### Deploy a Group Site\n\nTo deploy a group into a site, make sure you have a domain name and\na server with the following requirements:\n\n1. At least 2GB RAM\n2. Al least 512MB free space in root partition.\n3. Port 56000 open so the p2p connections can reach the server.\n\nAfter checking that, run the following command in the server:\n\n```shell\nsh \u003c(curl -sL https://raw.githubusercontent.com/seed-hypermedia/seed/main/website_deployment.sh) https://example.com\n```\n\nreplacing `https://example.com` by your \u003c`address`\u003e If everything went well,\nafter some seconds, you should be watching a final output line like\n`https://example.com/secret-invite/XXXX`. You should paste that link back into\nthe owner's application to register the newly created site and start publihing.\nThe site deployment workspace will default to `~/.seed-site`.\n\n#### Auto-Update a Site\n\nIf you want the site to auto update to latest stable images when they are pushed,\njust execute the installation command with the `--auto-update` flag. Ex:\n\n```shell\nsh \u003c(curl -sL https://raw.githubusercontent.com/seed-hypermedia/seed/main/website_deployment.sh) https://example.com --auto-update\n```\n\n#### Replace Site\n\nIf you want to replace an old site with a new site in a different domain in the same machine,\nyou need to redeploy the site from scratch. Note that old content will be available as long as\nthe owner of the site is synced with the site at the moment of the replacement. On the server:\n\n```shell\ndocker stop seed-web\nmv ~/.seed-site ~/.seed-site.bak\ndocker start seed-web\n```\n\nGet the new secret link from the command line after starting the `seed-web` container\nNow in the Seed App, the Owner of the site can go to the group he/she wants to (re)deploy\nand click on the three dots, and publish group to site. Enter the new secret and the old content\nshould be now available in the new site. If there is no new content (A completely new group), then\nthe site will be empty ready to accept documents\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseed-hypermedia%2Fseed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseed-hypermedia%2Fseed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseed-hypermedia%2Fseed/lists"}