Anil-matcha/open-dots

Open-source alternative to OpenAI Dots: self-hosted AI chat, tools, approvals, connectors, and computer tasks.

Python

4,343

85 commits

updated Sep 29, 2026

See the code

See what people are saying

SourceMessageScoreDate

Open Dots: Open-Source Alternative to OpenAI Dots

3

Sep 29, 2026

README

Open Dots: Open-Source Alternative to OpenAI Dots

▶ Watch the 45-second demo

Open Dots is an open-source alternative to OpenAI Dots: a self-hosted AI workspace for chat, tool use, approvals, connectors, and computer tasks. It brings model conversations, a governed action gateway, approval prompts, and an optional isolated browser runtime into one local-first app.

Open Dots is independently built and is not affiliated with or endorsed by OpenAI, xAI, or any model provider. It offers a self-hostable, inspectable alternative for people looking for an open-source OpenAI Dots alternative, with local data and explicit approval for higher-risk actions.

Status: Prototype / active development. Intended for local experimentation; multi-user hosting and hostile-web isolation are not production ready.

What it does

  • Create assistant personas with separate instructions, model IDs, and visual identities.
  • Stream chat responses, persist conversations locally, render Markdown, attach images, and dictate messages where the browser supports speech input.
  • Connect to models through the included inference adapter and choose from its configured model catalog.
  • Request confined workspace reads and writes or computer actions through a deny-by-default gateway. Higher-risk actions pause for approval and produce audit events.
  • Connect apps through Composio, with explicit OAuth and narrow GitHub issue lookup/create actions.
  • Run an optional bot-scoped Docker/Playwright computer runtime or connect a compatible remote computer service.
  • Keep application state in SQLite and encrypt provider credentials at rest.

Why Open Dots

Open Dots gives developers and individuals a self-hosted AI workspace they can inspect and adapt. Use it as an open-source alternative to OpenAI Dots when you want local-first conversation storage, configurable model access, visible approval steps, and an optional computer runtime under your control. It is a separate project with its own implementation and current limitations; see the provider and runtime notes below before deploying it.

Quick start

Requirements

  • Node.js and npm
  • Python 3.10+ and pip
  • An inference API key and base URL for live model responses

Clone and start the API:

git clone https://github.com/Anil-matcha/open-dots.git
cd open-dots/server
python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
export MODEL_API_KEY="your_api_key"
export MODEL_API_BASE_URL="https://your-inference-host.example/api/v1"
python run.py

The API is available at http://127.0.0.1:8000; interactive docs are at /docs.

In a second terminal, start the web client:

cd open-dots/client
npm install
npm run dev

Open http://localhost:3000. You can enter the provider key in App Settings instead of setting the environment variable. The server creates local session and encryption keys under its data directory on first start.

Model provider

The bundled inference adapter sends a prediction request to {MODEL_API_BASE_URL}/{model_id} and uploads images to {MODEL_API_BASE_URL}/upload_file. Configure it with a service that implements this request and response contract and supports the model IDs you select. This adapter does not implement the generic OpenAI-compatible chat completions interface.

VariableDefaultPurpose
MODEL_API_KEYemptyProvider key fallback when no key is saved in settings
MODEL_API_BASE_URLemptyRequired base URL for the configured inference API
DEFAULT_MODELgpt-5-miniInitial model for new assistants
COMPOSIO_API_KEYemptyOptional connector credential
DATA_DIR~/.open-dotsSQLite state and local keys
APP_ENCRYPTION_KEYgenerated in DATA_DIROptional Fernet key for encrypted credentials
APP_AUTH_TOKENgenerated in DATA_DIRBearer token for direct or non-loopback API access
WORKSPACE_ROOTproject rootDirectory boundary for approved workspace actions
COMPUTER_PROVIDERfakeComputer provider: fake, docker, or remote
HOST / PORT127.0.0.1 / 8000API bind address

For non-loopback access, set APP_AUTH_TOKEN, configure the client with NEXT_PUBLIC_API_TOKEN, use HTTPS, and set a narrow CORS_ORIGINS list. Do not expose generated tokens in logs or source control.

Optional computer runtime

The default fake adapter is for local development and deterministic behavior. To enable the Docker/Playwright computer provider:

docker build -t open-dots-computer:1.62.1 ./runtime
export COMPUTER_PROVIDER=docker
export COMPUTER_DOCKER_IMAGE=open-dots-computer:1.62.1

The daemon must be running. Containers use a separate workspace per assistant, a read-only root filesystem, dropped capabilities, and resource limits. Computer navigation and other higher-risk operations go through the action gateway and approval flow. This is not a hardened sandbox for hostile websites; review network egress, image provenance, and credential exposure before using it with untrusted content.

For a remote computer service, configure COMPUTER_PROVIDER=remote and the COMPUTER_REMOTE_* variables in server/app/config.py.

Architecture

Next.js client ── HTTP + SSE ── FastAPI API
                                  ├── SQLite + encrypted settings
                                  ├── configurable inference adapter
                                  ├── Composio connector adapter
                                  └── action gateway + approvals + audit
                                        ├── confined workspace tools
                                        └── fake / Docker / remote computer

The main code areas are client/ (Next.js UI), server/app/routers/ (HTTP API), server/app/services/ (providers, persistence, approvals, and tools), and runtime/ (Docker computer driver).

Current limitations

  • One local owner; user provisioning, roles, and multi-user grants are not implemented.
  • SQLite is local state; coordinated multi-instance storage and backup workflows are not included.
  • The bundled inference adapter expects a specific prediction API contract; a generic provider plugin interface is not implemented.
  • The computer runtime is opt-in and is not a hardened security boundary for arbitrary web content.
  • Connector actions are intentionally narrow; arbitrary tool discovery and writes are not implemented.
  • There is no mobile or desktop client, durable memory service, or scheduled routine engine.

Contributing

Issues and pull requests are welcome. Keep the documentation aligned with behavior, avoid committing credentials or local transcripts, and describe API or persistence changes clearly.

License

MIT. See LICENSE.

agentic-ai
ai-agent
ai-assistant
ai-workspace
approval-workflows
browser-automation
computer-use
computer-use-agent
fastapi
llm
local-first
nextjs
openai-dots
open-source
open-source-alternative
python
react
self-hosted
self-hosted-ai
tool-use

Anil-matcha/open-dots

Open-source alternative to OpenAI Dots: self-hosted AI chat, tools, approvals, connectors, and computer tasks.

Python

4,343

85 commits

updated Sep 29, 2026

See the code

See what people are saying

SourceMessageScoreDate

Open Dots: Open-Source Alternative to OpenAI Dots

3

Sep 29, 2026

README

Open Dots: Open-Source Alternative to OpenAI Dots

▶ Watch the 45-second demo

Open Dots is an open-source alternative to OpenAI Dots: a self-hosted AI workspace for chat, tool use, approvals, connectors, and computer tasks. It brings model conversations, a governed action gateway, approval prompts, and an optional isolated browser runtime into one local-first app.

Open Dots is independently built and is not affiliated with or endorsed by OpenAI, xAI, or any model provider. It offers a self-hostable, inspectable alternative for people looking for an open-source OpenAI Dots alternative, with local data and explicit approval for higher-risk actions.

Status: Prototype / active development. Intended for local experimentation; multi-user hosting and hostile-web isolation are not production ready.

What it does

  • Create assistant personas with separate instructions, model IDs, and visual identities.
  • Stream chat responses, persist conversations locally, render Markdown, attach images, and dictate messages where the browser supports speech input.
  • Connect to models through the included inference adapter and choose from its configured model catalog.
  • Request confined workspace reads and writes or computer actions through a deny-by-default gateway. Higher-risk actions pause for approval and produce audit events.
  • Connect apps through Composio, with explicit OAuth and narrow GitHub issue lookup/create actions.
  • Run an optional bot-scoped Docker/Playwright computer runtime or connect a compatible remote computer service.
  • Keep application state in SQLite and encrypt provider credentials at rest.

Why Open Dots

Open Dots gives developers and individuals a self-hosted AI workspace they can inspect and adapt. Use it as an open-source alternative to OpenAI Dots when you want local-first conversation storage, configurable model access, visible approval steps, and an optional computer runtime under your control. It is a separate project with its own implementation and current limitations; see the provider and runtime notes below before deploying it.

Quick start

Requirements

  • Node.js and npm
  • Python 3.10+ and pip
  • An inference API key and base URL for live model responses

Clone and start the API:

git clone https://github.com/Anil-matcha/open-dots.git
cd open-dots/server
python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
export MODEL_API_KEY="your_api_key"
export MODEL_API_BASE_URL="https://your-inference-host.example/api/v1"
python run.py

The API is available at http://127.0.0.1:8000; interactive docs are at /docs.

In a second terminal, start the web client:

cd open-dots/client
npm install
npm run dev

Open http://localhost:3000. You can enter the provider key in App Settings instead of setting the environment variable. The server creates local session and encryption keys under its data directory on first start.

Model provider

The bundled inference adapter sends a prediction request to {MODEL_API_BASE_URL}/{model_id} and uploads images to {MODEL_API_BASE_URL}/upload_file. Configure it with a service that implements this request and response contract and supports the model IDs you select. This adapter does not implement the generic OpenAI-compatible chat completions interface.

VariableDefaultPurpose
MODEL_API_KEYemptyProvider key fallback when no key is saved in settings
MODEL_API_BASE_URLemptyRequired base URL for the configured inference API
DEFAULT_MODELgpt-5-miniInitial model for new assistants
COMPOSIO_API_KEYemptyOptional connector credential
DATA_DIR~/.open-dotsSQLite state and local keys
APP_ENCRYPTION_KEYgenerated in DATA_DIROptional Fernet key for encrypted credentials
APP_AUTH_TOKENgenerated in DATA_DIRBearer token for direct or non-loopback API access
WORKSPACE_ROOTproject rootDirectory boundary for approved workspace actions
COMPUTER_PROVIDERfakeComputer provider: fake, docker, or remote
HOST / PORT127.0.0.1 / 8000API bind address

For non-loopback access, set APP_AUTH_TOKEN, configure the client with NEXT_PUBLIC_API_TOKEN, use HTTPS, and set a narrow CORS_ORIGINS list. Do not expose generated tokens in logs or source control.

Optional computer runtime

The default fake adapter is for local development and deterministic behavior. To enable the Docker/Playwright computer provider:

docker build -t open-dots-computer:1.62.1 ./runtime
export COMPUTER_PROVIDER=docker
export COMPUTER_DOCKER_IMAGE=open-dots-computer:1.62.1

The daemon must be running. Containers use a separate workspace per assistant, a read-only root filesystem, dropped capabilities, and resource limits. Computer navigation and other higher-risk operations go through the action gateway and approval flow. This is not a hardened sandbox for hostile websites; review network egress, image provenance, and credential exposure before using it with untrusted content.

For a remote computer service, configure COMPUTER_PROVIDER=remote and the COMPUTER_REMOTE_* variables in server/app/config.py.

Architecture

Next.js client ── HTTP + SSE ── FastAPI API
                                  ├── SQLite + encrypted settings
                                  ├── configurable inference adapter
                                  ├── Composio connector adapter
                                  └── action gateway + approvals + audit
                                        ├── confined workspace tools
                                        └── fake / Docker / remote computer

The main code areas are client/ (Next.js UI), server/app/routers/ (HTTP API), server/app/services/ (providers, persistence, approvals, and tools), and runtime/ (Docker computer driver).

Current limitations

  • One local owner; user provisioning, roles, and multi-user grants are not implemented.
  • SQLite is local state; coordinated multi-instance storage and backup workflows are not included.
  • The bundled inference adapter expects a specific prediction API contract; a generic provider plugin interface is not implemented.
  • The computer runtime is opt-in and is not a hardened security boundary for arbitrary web content.
  • Connector actions are intentionally narrow; arbitrary tool discovery and writes are not implemented.
  • There is no mobile or desktop client, durable memory service, or scheduled routine engine.

Contributing

Issues and pull requests are welcome. Keep the documentation aligned with behavior, avoid committing credentials or local transcripts, and describe API or persistence changes clearly.

License

MIT. See LICENSE.

agentic-ai
ai-agent
ai-assistant
ai-workspace
approval-workflows
browser-automation
computer-use
computer-use-agent
fastapi
llm
local-first
nextjs
openai-dots
open-source
open-source-alternative
python
react
self-hosted
self-hosted-ai
tool-use

Languages

Python

63.4%

JavaScript

36.0%