Self-hosted and local-first. Bring any model, connect your tools, and approve every risky action.
Quick start · Features · How it works · Documentation · FullDots and OpenDots
Scout compared five hosts, saved the result into a Space and the table opened beside the conversation. Nothing here left the machine except the model request.
Hire a flock, not a chatbot. Most AI tools give you one chat box and ask you to trust it. FullDots gives you a small team and keeps you in charge of it.
Each Dot is a coworker with a role, a model, the tools you grant it and, if you want, a computer of its own with a browser, files and a shell. You talk to it, hand it standing goals, let it call on its teammates and review what it did. Every Dot is a round penguin with its own colour, species and gear, so a team reads at a glance, and the penguin shows what it is doing right now.
Everything lives in one SQLite file. There are no accounts, no telemetry and no hosted service in the middle; the app talks only to the model providers and connectors you set up.
Note
FullDots is built for a single owner: there are no user accounts or shared workspaces. It started as a fork of CopilotKit OpenDots; see FullDots and OpenDots.
Version 2.1.0 puts FullDots on your desktop.
- A desktop app for Windows, macOS and Linux. It runs FullDots on your own computer in a window of its own, keeps your Dots working from the tray, and updates itself. It is the same app as the web version, from the same code. See Desktop.
- A calmer window. A frame, a slim rail of your Dots and one panel for the page. A new chat is one line of text and the message box.
- One shelf for a Space. Pages and files together, with tabs by kind, pictures shown as pictures, and who made each item: you or one of your Dots.
- More for Dot computers. A full Linux desktop, Codex beside Claude Code, and a page reader that uses the browser you already have.
The full list is in the changelog.
Version 2.0.0 is the first release that feels like a workplace rather than a prototype.
| Before | Now |
|---|---|
| One Dot at a time, one chat at a time | Teams. A Dot hands part of a task to the teammate whose role fits, and the answer returns to the same conversation. |
| Results lived inside chat messages | Spaces with files. Dots save CSVs, reports and HTML pages, and a card in the chat opens them beside the conversation. |
| A generic avatar | Penguin Dots. Five species, five pieces of gear, nine colours, and live states: thinking, writing, working, waiting. |
| Work stopped when you closed the tab | Always-on work. Standing goals, webhook and poll triggers, parallel background turns and per-Dot token budgets. |
| You asked, the Dot answered | Mission control, an inbox and group chats. See who is busy, what needs you, and @mention several Dots into one chat. |
| Searching depended on a service that blocks servers | Search with the Dot's own browser, a private SearXNG as a fallback, and a headed browser that captchas far less. |
| Setting up Docker by hand | Guided setup for Dot computers. Every command is shown, and nothing runs until you allow it. |
The full list, including every ported upstream fix, is in the changelog.
Dots are what you make them. These five come up in most setups.
Choose each Dot's colour, species (Emperor, Adélie, Rockhopper, Macaroni or Chick) and gear (headphones, glasses, beanie, scarf or bow tie) in its settings. Three pulsing dots mean it is thinking, hopping dots mean it is writing, focused eyes mean it is using a tool, an amber badge means it needs you, and confetti means it is done. The brand notes list every state: docs/brand.
![]() |
![]() |
| Make a Dot yours. Colour, species and gear, then its role, model, connectors and approval rules. | Mission control. Who is working, who is waiting on you, and what each Dot has used today. |
A walk through what 2.0 is for, using nothing but the features in this repository.
- Morning. Open mission control. Ledger finished a standing goal overnight and found nothing odd; Sage has a plan waiting for your review. One card in the inbox needs you: Pilot wants to publish a post.
- Ask. You tell Scout to compare hosting for a single-owner deployment. It searches with its own browser, reads three pages and saves
hosting-options.csvinto the Launch week Space. The card opens a sortable table beside the chat. - Hand off. You ask Scout for release notes too. It passes that to Quill, who works in a separate conversation and returns the draft to Scout's chat. A lane in the chat shows Quill's progress while it works.
- Approve. Pilot's post pauses on an approval card showing the exact text and destination. You approve that one action, once. A password prompt along the way stops Pilot instead: you take over its live screen, type the secret yourself and hand the screen back.
- Evening. Ledger's budget warning lands in your notification webhook. You pause one Dot, run
npm run backupand close the laptop. Anything that was waiting for you is still waiting after a restart.
Yours. One SQLite file holds conversations, pages, files, settings and the audit trail. Keys and tokens are encrypted at rest with AES-256-GCM and never sent to the browser. Back everything up with npm run backup, even while FullDots runs.
Asked first. Sending, paying, deleting, publishing and destructive commands pause for you. An approval covers that exact action, once, and survives a restart. Dots reach only the Spaces, connectors and tools you grant, and connectors are read-only by default.
Any model. Fourteen provider presets, from OpenAI, Anthropic and Gemini to Ollama and LM Studio, plus any OpenAI-compatible server. Each Dot can use its own model.
FullDots has one look, shared by the app and its website, and it opens in the dark theme.
- Quiet chrome. Flat neutral greys, thin rims and no drop shadows. Colour is kept for two things: the Dots, who each have their own, and status, which is always written in words too (amber always means "waiting for you").
- One typeface. Geist for text and Geist Mono for code. Both are bundled and served by FullDots itself, so the interface makes no outside requests.
- A calm chat. Your messages sit in a solid bubble and answers read as plain text. The message box is a rounded pill whose rim brightens while you type.
- Mission control at a glance. Each Dot sits in its own band at the top of its card, with a coloured status pill, its queue and today's tokens.
- Your choice of theme. Dark by default; Settings → General → Appearance switches to Light or to System. Both themes meet WCAG AA contrast for text, and a test keeps them in step.
The chat at the top of this page, in the Light theme. Everything else on this page is shown in Dark, the default.
| Area | What you get |
|---|---|
| Interface | Dark by default, with Light and System themes; Geist typeface; installs as an app on phones and desktops |
| Chat | Pin, retry, branch, edit and resend; export a conversation as Markdown; Ctrl+K search across chats, pages, Dots, prompts |
| Computers | One container per Dot with a browser, files and a shell; live screen, replay, take-over and an audit trail |
| Notes | Visible notes of what each Dot remembers about you, which you can read, edit and roll back |
| Automations | Standing goals, schedules, webhook triggers with signed secrets, connector polls. See Automations |
| Budgets | Tokens per Dot per day from the provider's own counts, a daily warning and an optional hard budget |
| Limits | Steps, time, shell command time and file size, all set in .env |
| Notifications | Optional webhook for new approvals, hand-offs and usage warnings (title, text and link only) |
| Tests | 2,720 tests, including a planted-secret leak test that fails if a key reaches a response, log or webhook |
Requirements: Node.js 24 or newer with npm, and either an API key for a supported provider or a local Ollama or LM Studio server.
git clone https://github.com/asasemahmed/FullDots.git
cd FullDots
npm ci
cp .env.example .env
npm run devOpen http://127.0.0.1:5173, then add a provider in Settings → Models. You can also set OPENAI_API_KEY, OPENAI_BASE_URL and OPENAI_MODEL in .env and restart. Without a model the app shows a setup screen and never invents replies.
cp .env.example .env # set OWNER_TOKEN to a random string of 24+ characters
docker compose up --build -dOpen http://localhost:4310. The port is bound to loopback, and data lives in the opendots-data volume.
FullDots Desktop runs FullDots on your own computer in a window of its own, for Windows, macOS and Linux, and updates itself. It is the same app as the web version, from the same code. Download it from the latest release, or run it from source:
npm ci
npm --prefix desktop ci
npm run desktopSee Desktop.
Deploy on your own server with HTTPS, a domain and automated backups: see Deploy on a VPS for a plain Linux VPS with Docker, or Deploy on Dokploy to manage it from GitHub.
- Dot computers need Docker. The Computer panel can walk you through it. See Computers.
- Page reader, voice calls and backups are covered in Setup.
- Connectors are added in Settings → Connectors. See Connectors.
- Slack and Telegram let your listed owner accounts talk to a Dot and use approval buttons. Set them up in Settings → Channels. See Channels.
- Spaces keep pages and files. See Spaces.
Every turn runs through the server. Before a Dot uses a computer, a connector or a teammate, the approval gate checks the action against that Dot's grants and approval mode. An action that needs you pauses the turn and is recorded, and the turn resumes once you decide. Only one turn runs per Dot at a time, across chat, voice, schedules and resumes, and a Stop button ends it.
All settings live in .env. .env.example lists every variable with its default.
| Variable | Purpose |
|---|---|
OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL |
The built-in default provider. Add others in Settings → Models. |
OWNER_TOKEN |
Required (24+ characters) when HOST is not loopback, and by the Docker setup. |
APP_ORIGIN |
The exact address you open the app at. Browser sign-in for connectors redirects back to it. |
DATABASE_PATH |
The SQLite file. Default data/opendots.sqlite. |
CONNECTOR_SECRET_KEY |
Key for stored secrets. If unset, data/connector.key is created once. |
WEB_SEARCH_PROVIDER, SEARXNG_URL |
duckduckgo (default), browser, searxng (your own SearXNG) or disabled. |
COMPUTER_BROWSER_MODE |
headed (default, far fewer captchas) or headless for Dot computers. |
SPACE_FILE_MAX_MB |
Largest file a Space accepts. Default 10, at most 50. |
CONNECTORS_ALLOW_STDIO |
Lets connectors start local programs. Off by default. |
AGENT_TURN_TIMEOUT, AGENT_MAX_STEPS |
How long and how many steps a Dot may take in one turn. Defaults: 90 seconds and 8 steps. |
NOTIFY_WEBHOOK_URL |
Optional. Receives a title, text and link for new approvals, hand-offs and usage warnings. |
BACKGROUND_CONCURRENCY |
Background tasks running at once (different Dots). Default 4, at most 8. |
DOT_DAILY_TOKEN_WARN |
Tokens per Dot per day before you are warned. Default 2,000,000. |
TEAM_MAX_DEPTH, DELEGATION_TIMEOUT |
How many hand-offs may chain (default 2) and how long a teammate may work (default 300 s). |
- Your data stays local. Outbound traffic goes only to your model providers, your search provider, the connectors you add and the pages a Dot reads.
- Secrets are encrypted. Model keys and connector tokens use AES-256-GCM. Secrets set in
.envare read from the environment and never stored or shown. - Remote access needs a token. The server refuses to start on a non-loopback
HOSTwithout anOWNER_TOKENof 24+ characters. - Risky actions wait for you. Approvals and hand-offs keep you in the loop. The checks are heuristics, not a sandbox; see Approvals.
- Stored files cannot run. HTML a Dot saves previews in a frame with every sandbox restriction on, and scripts are only ever downloads. See Spaces.
- Leaks are tested.
tests/security.test.tsplants secrets where the server keeps them and checks that none reach a response, webhook, model request, stored conversation, audit record or log line.
FullDots has not been independently audited. Read SECURITY.md for the design, its limits and how to report a vulnerability privately.
npm test # Vitest suite
npm run typecheck # TypeScript, no emit
npm run lint # ESLint
npm run check-format # Prettier
npm run build # production build, then `npm start`
npm run backup # consistent copy of the database and its key
npm run brand # redraw the logo and penguin art from the same code the app usesProject layout
src/
client/ React app: chat, sidebar, Spaces, settings, Dot form, computer panel, penguins
server/ Hono server: agent runtime, SQLite runner, connectors, approvals, teams, search
shared/ Types and presets shared by client and server
browser/ Page reader service (Playwright)
tests/ Vitest suites, fixtures and the security regression test
deployment/ Docker images for the app and Dot computers
docs/ Guides, brand assets and screenshots
Where each feature lives in the code
| Feature | Code |
|---|---|
| Local conversations | sqlite-runner.ts |
| No telemetry | privacy.ts, imported first in index.ts |
| Web search | web-search.ts, browser-search.ts |
| Model providers | model-providers.ts, model-presets.ts |
| Encrypted secrets | connector-crypto.ts |
| MCP connectors | connectors.ts, connector-oauth.ts, connector-auth-store.ts |
| Approvals | approval-gate.ts, approvals.ts, resume-queue.ts |
| Owner hand-off | handoff-service.ts, handoff-detect.ts |
| Teams | team-service.ts, lanes.ts |
| Spaces, pages and files | pages.ts, space-files.ts, space-file-tools.ts |
| One turn per Dot | turn-registry.ts |
| Live computer view | computer-stream.ts, computer-panel/ |
| Work limits | limits.ts |
| Audit and notifications | computer-store.ts, notify.ts |
| Penguin Dots | penguin/engine.ts, penguin/live.ts, DotCharacter.tsx, docs/brand/ |
| Guide | Covers |
|---|---|
| Setup | Running, Docker, storage, search and backups |
| Desktop | The desktop app, its data folder and updates |
| Deploy on a VPS | Hosting on a plain Linux VPS with Docker |
| Deploy on Dokploy | Hosting on your own server from GitHub |
| Models | Providers, keys and per-Dot models |
| Agents | A Dot whose brain is an agent you run |
| Connectors | MCP connectors, browser sign-in and grants |
| Approvals | Modes, what pauses, hand-offs and resumes |
| Automations | Goals, triggers, parallel work, token budgets |
| Teams | Hand-offs between Dots |
| Spaces | Pages, files and what Dots can save |
| Computers | A computer for each Dot |
| Interface | The chat, sidebar, themes and accessibility |
| Brand | Logo, penguin Dots, their states and colours |
| Roadmap | What is done and what is next |
| Changelog | What changed in each release |
FullDots was forked from CopilotKit OpenDots at upstream commit c2569bb (2 October 2026), and the upstream history is kept in this repository.
| OpenDots at the fork point | FullDots | |
|---|---|---|
| Conversation storage | Hosted CopilotKit Intelligence | Local SQLite |
| Web search | Parallel by default, with a key | Keyless, or through the Dot's own browser |
| Telemetry | CopilotKit telemetry | Off |
| Models | One provider set in .env |
14 presets, encrypted keys, a model per Dot |
| Connectors | None | MCP with browser sign-in and per-Dot grants |
| Approvals and hand-off | None | Risky actions pause, and you type the secrets |
| Teams, Spaces with files | None | Hand-offs, files and result cards |
| Slack, Automatic Learning | Included | Removed (both depend on Intelligence) |
OpenDots has kept moving since the fork. FullDots does not merge upstream wholesale; useful changes are ported one at a time, adapted and tested, and listed in the changelog. Not ported: dark mode (#81; FullDots has its own dark and light themes), OpenDots's per-Dot MCP connections (#52, FullDots has its own connectors), and anything tied to telemetry or the hosted Intelligence service.
FullDots is an independent project, not affiliated with or endorsed by CopilotKit. Thanks to Atai Barkai and the CopilotKit team for OpenDots, and for CopilotKit, AG-UI and OpenBot, which FullDots builds on. See NOTICE.md.
Bug reports, fixes and tests are welcome. Please read CONTRIBUTING.md first, and report security problems privately as described in SECURITY.md. The open issues list what is up for grabs.
MIT. Copyright (c) Atai Barkai. Copyright (c) 2026 asemabdallah (FullDots modifications).





