{"id":48752155,"url":"https://github.com/alexk-dev/golemcore-brain","last_synced_at":"2026-04-16T00:01:13.535Z","repository":{"id":350370702,"uuid":"1205542857","full_name":"alexk-dev/golemcore-brain","owner":"alexk-dev","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-14T23:22:04.000Z","size":579,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T23:37:53.592Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/alexk-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":null,"dco":null,"cla":null}},"created_at":"2026-04-09T03:57:12.000Z","updated_at":"2026-04-14T23:21:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"d38fd5fe-5113-4bc8-87d4-48991d365059","html_url":"https://github.com/alexk-dev/golemcore-brain","commit_stats":null,"previous_names":["alexk-dev/golemcore-brain"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/alexk-dev/golemcore-brain","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-brain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-brain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-brain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-brain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexk-dev","download_url":"https://codeload.github.com/alexk-dev/golemcore-brain/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-brain/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31865078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: 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":"2026-04-12T20:05:31.510Z","updated_at":"2026-04-16T00:01:13.528Z","avatar_url":"https://github.com/alexk-dev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GolemCore Brain\n\nGolemCore Brain is a self-hosted knowledge workspace for teams that want a clean web UI without giving up plain Markdown files.\n\nIt keeps docs, runbooks, notes, and project knowledge on disk as readable `.md` files, then adds the application layer teams need day to day: editing, navigation, search, assets, permissions, and optional LLM-powered workflows.\n\n## Demo\n\n[![GolemCore Brain demo](docs/assets/demo-poster.jpg)](docs/assets/demo.mp4)\n\n## Why Brain\n\nMost internal knowledge tools make teams choose between a good product experience and portable content. Brain is built for the middle ground: people work in a focused wiki, while the source of truth stays simple enough to back up, diff, move, and rebuild.\n\nUse it for:\n\n- team handbooks, runbooks, and operating procedures\n- product and engineering documentation\n- customer, project, or team-specific knowledge spaces\n- Markdown notes that need a real browser-based workspace\n- searchable context for internal tools and LLM workflows\n\n## Core Capabilities\n\n- **Markdown source of truth** - pages are stored as local Markdown files instead of being locked inside a primary database.\n- **Organized spaces** - keep teams, projects, customers, or environments separated in one running instance.\n- **Fast editing flow** - create, edit, rename, move, copy, reorder, convert, and delete pages from the UI.\n- **Assets where the docs live** - upload images and files, manage them from the page, and insert them into Markdown.\n- **Search that can be rebuilt** - index title and body content from the files, with optional semantic search when embeddings are configured.\n- **Roles and access control** - use admin, editor, and viewer roles, public read-only mode, and API keys for programmatic access.\n- **LLM-ready workflows** - configure model providers once, then use them for semantic indexing, space chat, and space-scoped Dynamic APIs.\n- **Simple self-hosting** - run a Spring Boot application with the frontend bundled into the same artifact.\n\n## How Content Is Stored\n\nBrain stores wiki content under `data/wiki` by default. Markdown files are the source of truth; search indexes and generated metadata are derived data.\n\n```text\ndata/wiki/\n  spaces/\n    \u003cspace-id\u003e/\n      index.md\n      guides/\n        index.md\n        runbook.md\n      .order.json\n  .indexes/\n```\n\nA section is a directory with an `index.md`. A page is a standalone `.md` file. `.order.json` stores the order users set in the UI.\n\n## Run Locally\n\nBuild the backend and bundled frontend:\n\n```bash\n./mvnw package\njava -jar target/golemcore-brain-*.jar\n```\n\nThe app starts on `http://localhost:8080`.\n\nTo run the published container image with Docker Compose:\n\n```bash\nexport BRAIN_ADMIN_PASSWORD='replace-this-password'\nexport BRAIN_JWT_SECRET=\"$(openssl rand -hex 32)\"\ndocker compose up -d\n```\n\nThe example [docker-compose.yml](docker-compose.yml) stores wiki data in a named Docker volume and exposes the app on `http://localhost:8080`.\n\nFor frontend-only development:\n\n```bash\ncd frontend\nnpm install\nnpm run dev\n```\n\nThe Vite dev server proxies `/api` to the backend on `http://localhost:8080`.\n\n## Configuration\n\nSet the initial admin account before the first run:\n\n```bash\nBRAIN_ADMIN_USERNAME=admin \\\nBRAIN_ADMIN_PASSWORD=change-me \\\njava -jar target/golemcore-brain-*.jar\n```\n\nFor production, enable the `prod` profile and provide a strong JWT secret:\n\n```bash\nSPRING_PROFILES_ACTIVE=prod \\\nBRAIN_ADMIN_USERNAME=admin \\\nBRAIN_ADMIN_PASSWORD=change-me \\\nBRAIN_JWT_SECRET=change-me-change-me-change-me-change-me \\\njava -jar target/golemcore-brain-*.jar\n```\n\nCommon settings:\n\n- `BRAIN_STORAGE_ROOT` - where wiki files and derived indexes are stored\n- `BRAIN_SITE_TITLE` - product name shown in the UI\n- `BRAIN_PUBLIC_ACCESS` - enables read-only public access when set to `true`\n- `BRAIN_SESSION_TTL_SECONDS` - session lifetime\n- `BRAIN_DEFAULT_SPACE_SLUG` and `BRAIN_DEFAULT_SPACE_NAME` - initial space identity\n\n## Checks\n\n```bash\n./mvnw test\ncd frontend \u0026\u0026 npm run lint \u0026\u0026 npm run build\n```\n\n## License\n\nGolemCore Brain is licensed under the [Apache License 2.0](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexk-dev%2Fgolemcore-brain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexk-dev%2Fgolemcore-brain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexk-dev%2Fgolemcore-brain/lists"}