{"id":47619431,"url":"https://github.com/vcmf/dim0","last_synced_at":"2026-05-30T21:01:07.151Z","repository":{"id":345963001,"uuid":"1187493898","full_name":"vcmf/dim0","owner":"vcmf","description":"An open-source AI thinking canvas - notes, docs, code, widgets, and an agent that works directly on the board.","archived":false,"fork":false,"pushed_at":"2026-05-25T11:56:25.000Z","size":20677,"stargazers_count":28,"open_issues_count":1,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-25T13:33:48.940Z","etag":null,"topics":["ai-agent","canvas","code-execution","fast-api","infinite-canvas","knowledge-graph","mindmap","note-taking","productivity","qdrant","rag","react","research-tool","second-brain","semantic-search","thinking-canvas","whiteboard","widgets"],"latest_commit_sha":null,"homepage":"https://dim0.net","language":"TypeScript","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/vcmf.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-03-20T19:42:54.000Z","updated_at":"2026-05-24T21:08:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"560c6f00-9a7d-4da0-b03f-24d049a2e4d1","html_url":"https://github.com/vcmf/dim0","commit_stats":null,"previous_names":["vcmf/dim0"],"tags_count":68,"template":false,"template_full_name":null,"purl":"pkg:github/vcmf/dim0","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vcmf%2Fdim0","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vcmf%2Fdim0/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vcmf%2Fdim0/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vcmf%2Fdim0/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vcmf","download_url":"https://codeload.github.com/vcmf/dim0/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vcmf%2Fdim0/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33709269,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai-agent","canvas","code-execution","fast-api","infinite-canvas","knowledge-graph","mindmap","note-taking","productivity","qdrant","rag","react","research-tool","second-brain","semantic-search","thinking-canvas","whiteboard","widgets"],"created_at":"2026-04-01T21:55:31.790Z","updated_at":"2026-05-30T21:01:07.144Z","avatar_url":"https://github.com/vcmf.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/dim0-icon.png\" alt=\"Dim0\" width=\"96\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eDim0 - The Thinking Canvas\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/affiche.png\" alt=\"Dim0 - Your canvas thinks back\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Notes, code, widgets, and documents on one board - and an agent that can read what's on it and write back into it. \u003cstrong\u003eYour work is yours: privacy-first, your data stays yours.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://dim0.net\"\u003e🌐 Website\u003c/a\u003e · \u003ca href=\"https://app.dim0.net\"\u003e🚀 Live App\u003c/a\u003e · 🔒 Privacy-first · 📄 MIT License\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  ⭐ Star if Dim0 is useful to you. It helps others find the project.\n\u003c/p\u003e\n\n![Dim0 app screenshot](docs/images/themes-light-dark.png)\n*A board with notes, charts, visual explainers, and the agent - all in the same workspace, in light and dark.*\n\nhttps://github.com/user-attachments/assets/cdc7d3d4-eb59-4d7d-a9ff-6f0206ba82df\n\n## What it is\n\nMost AI tools start with a chat box and bolt the rest of the product on around it. Dim0 goes the other way - the board is the workspace, and the agent is one of the things living on it.\n\nThe board holds notes, code sandboxes, widgets, documents, nested boards, and presentation frames, all sitting next to each other. The agent can see what's there, take multiple steps with tools, and drop its results back onto the same canvas.\n\nThings it can do:\n\n- Read the current board and any selected nodes\n- Search the web and fetch pages\n- Run code in a sandbox\n- Create and edit notes\n- Generate widgets and small visual explainers\n- Save and recall semantic memory\n\n## Node types\n\nEverything on the board is a node:\n\n- **Shapes** - diagrams and spatial structure\n- **Notes** - rich text, edited in place\n- **Code sandboxes** - write code, run it\n- **Widgets** - embedded HTML/JS, charts, visual explainers, interactive tools\n- **Documents** - uploaded files, also fed into retrieval\n- **Nested boards** - for when one board isn't enough\n- **Frames** - turn the canvas into a presentation\n\n![Shapes on a board](docs/images/board-shapes.png)\n*Shapes for diagrams, flowcharts, and spatial layout.*\n\n![Rich notes](docs/images/board-notes.png)\n*Notes are first-class - rich text, math, code, edited in place.*\n\n![Widgets](docs/images/board-widgets.png)\n*Widgets render charts and interactive explainers right on the canvas.*\n\n![Mindmap from shapes and notes](docs/images/board-mindmap.png)\n*Mix shapes and notes to think through a topic spatially.*\n\nhttps://github.com/user-attachments/assets/ad5de9f4-6f44-43a2-b59a-5279232d7f60\n\n## Canvas engine\n\nThe board is built on [canvas-harness](https://github.com/winlp4ever/canvas-harness), a canvas-rendered node-graph library we maintain separately. Boards can hold thousands of nodes and still pan, zoom, and edit smoothly — comparable to tldraw and Excalidraw, and on par with hosted tools like Miro or FigJam.\n\n## Agent layer\n\nBuilt on the OpenAI Agents SDK, with board-aware tools wired in:\n\n- Board context - current graph and selected nodes\n- Notes - create, edit, link\n- Web - search and fetch\n- Code - run in Daytona-backed sandboxes\n- Widgets - generate inline visual outputs\n- Memory - semantic store and recall, via Qdrant\n\nModels: OpenAI, Anthropic, Google Gemini, Mistral, Moonshot, DeepSeek, Qwen, Z.ai.\n\n![Ask a question, get a visual answer](docs/images/agent-flow.png)\n*Ask a question on the board - the agent answers with a widget, a mindmap, or a note, dropped back where you're working.*\n\n## Themes\n\nLight, dark, and a set of paper-and-ink variants. The canvas adapts; so do notes, widgets, and shapes.\n\n![Theme showcase](docs/images/themes-showcase.png)\n*A few of the available themes.*\n\n## Try it\n\n- Hosted: https://app.dim0.net\n- Site: https://dim0.net\n- Self-host: see below\n\n## Repo layout\n\n- `backend/` - API, agent logic, prompts, model integrations, persistence\n- `webui/` - React frontend (canvas, chat, board UX)\n- `build/` - Docker Compose and build helpers\n\n## Getting started\n\n### Prerequisites\n\n- Node.js (LTS)\n- `uv` for Python deps\n- Docker + Docker Compose (recommended for local services)\n\n### Environment\n\nCopy `.env.sample` to `.env` and fill in the keys.\n\n```bash\ncp .env.sample .env\n```\n\nAt minimum, set:\n\n- `OPENAI_API_KEY`\n- `MISTRAL_API_KEY`\n- `OPENROUTER_API_KEY`\n- `LINKUP_API_KEY`\n\nThe rest of `.env.sample` covers additional providers and tools.\n\nA couple of things worth knowing:\n\n- Backend and frontend both read the root `.env`\n- Only variables prefixed with `VITE_` reach the frontend\n\n### Run published images\n\n```bash\nmake pull\nmake run\n```\n\nThen open `http://localhost:3000`.\n\nStop it:\n\n```bash\nmake down-run\n```\n\nStop it and wipe volumes:\n\n```bash\nmake kill-run\n```\n\n### Run from source\n\nIf you'd rather run the source instead of the published images:\n\n#### Local databases\n\n```bash\nmake up-db\n```\n\n#### Backend\n\n```bash\ncd backend\nuv sync\nuv run python -m topix.api.app\n```\n\nPort comes from `API_PORT` in `.env` (defaults to `8081`).\n\n#### Frontend\n\n```bash\ncd webui\nnpm install\nnpm run dev\n```\n\nPort comes from `APP_PORT` in `.env` (defaults to `5175`).\n\n## Environment variables\n\n`.env.sample` is the canonical list - ports and origins, model provider keys, search and image provider keys, local service settings, backend auth and tracing. Use it as a checklist when setting things up.\n\n## Docker\n\nCompose stack with Makefile shortcuts.\n\n### Core commands\n\n| Command | What it does |\n| --- | --- |\n| `make up` | Build if needed and start all services |\n| `make up-build` | Rebuild images, then start |\n| `make build` | Build images only |\n| `make rebuild` | Rebuild without cache |\n| `make down` | Stop and remove containers |\n| `make kill` | Stop and remove containers, images, and volumes |\n\n### Services and debugging\n\n| Command | What it does |\n| --- | --- |\n| `make ps` | Show service status |\n| `make logs` | Tail logs for all services |\n| `make logs-s SERVICE=backend-dev` | Tail logs for one service |\n| `make up-s SERVICE=backend-dev` | Start one service |\n| `make build-s SERVICE=webui-dev` | Build one service |\n| `make restart-s SERVICE=backend-dev` | Rebuild and restart one service |\n| `make exec SERVICE=backend-dev CMD=\"bash\"` | Open a shell in a service |\n\n### Databases\n\n| Command | What it does |\n| --- | --- |\n| `make up-db` | Start only the databases |\n| `make down-db` | Stop only the databases |\n\n### Overrides\n\nOverride the profile and env file at invocation:\n\n```bash\nmake up PROFILE=local ENVFILE=.env\n```\n\nOr override ports and origins for quick tests:\n\n```bash\nmake up PROFILE=dev API_PORT=9090 API_HOST_PORT=9090 API_ORIGIN=http://localhost:9090\n```\n\n## Images\n\nPublic Docker Hub images, for self-hosting:\n\n- `winlp4ever/dim0-backend`\n- `winlp4ever/dim0-webui`\n\n```bash\ndocker pull winlp4ever/dim0-backend:0.1.5\ndocker pull winlp4ever/dim0-webui:0.1.5\n```\n\nTo run them locally, use the `make pull` / `make run` flow above.\n\n## Versioning\n\nOne semver for the whole product. The repo-root `VERSION` file is the source of truth, and release tooling syncs it into:\n\n- `backend/pyproject.toml`\n- `webui/package.json`\n- `webui/src-tauri/Cargo.toml`\n\nBumps use Commitizen with Conventional Commits.\n\n```bash\nmake version-check\nmake version-sync\nmake version-bump\n```\n\nGitHub Actions handle the version check, releases, and Docker publishing.\n\n## Troubleshooting\n\n- Frontend can't reach the API? Check `VITE_API_URL` in `.env`.\n- Port already in use? Change `API_PORT` or `APP_PORT`.\n- Env change not picked up? Restart backend and frontend after editing `.env`.\n- Want to see the resolved Compose config? `make config`.\n\n## License\n\nMIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvcmf%2Fdim0","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvcmf%2Fdim0","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvcmf%2Fdim0/lists"}