{"id":45981176,"url":"https://github.com/dorylab/dory","last_synced_at":"2026-06-04T10:00:51.379Z","repository":{"id":334747602,"uuid":"1131590355","full_name":"dorylab/dory","owner":"dorylab","description":"AI-native SQL workspace for modern data works. SQL Copilot, schema-aware editor, database chat, and operational tools in one place.","archived":false,"fork":false,"pushed_at":"2026-05-30T07:19:39.000Z","size":61066,"stargazers_count":210,"open_issues_count":17,"forks_count":13,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-05-30T08:16:40.880Z","etag":null,"topics":["ai","clickhouse","clickhouse-ui","data-studio","database","database-client","database-gui","database-management","database-tools","dbeaver-alternative","developer-tools","mysql","navicat-free","postgres","postgresql","query-editor","sql","sql-client","sql-editor"],"latest_commit_sha":null,"homepage":"https://getdory.dev","language":"TypeScript","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/dorylab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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":"2026-01-10T10:11:46.000Z","updated_at":"2026-05-30T07:19:43.000Z","dependencies_parsed_at":"2026-04-02T01:05:32.547Z","dependency_job_id":null,"html_url":"https://github.com/dorylab/dory","commit_stats":null,"previous_names":["dorylab/dory"],"tags_count":172,"template":false,"template_full_name":null,"purl":"pkg:github/dorylab/dory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorylab%2Fdory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorylab%2Fdory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorylab%2Fdory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorylab%2Fdory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dorylab","download_url":"https://codeload.github.com/dorylab/dory/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorylab%2Fdory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33899697,"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-06-04T02:00:06.755Z","response_time":64,"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","clickhouse","clickhouse-ui","data-studio","database","database-client","database-gui","database-management","database-tools","dbeaver-alternative","developer-tools","mysql","navicat-free","postgres","postgresql","query-editor","sql","sql-client","sql-editor"],"created_at":"2026-02-28T18:02:41.274Z","updated_at":"2026-06-04T10:00:51.367Z","avatar_url":"https://github.com/dorylab.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./public/app.png\" alt=\"Dory Logo\" width=\"120\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eDory\u003c/h1\u003e\n\n\n**Dory is an AI-native Data Workspace for modern databases.**  \n\n\u003e The AI-powered Data Studio you've been waiting for.\n\nIt combines intelligent SQL editing, context-aware AI assistance, conversational database exploration, and deep operational integration across modern databases into a single unified studio — helping you explore, monitor, and manage your data with the power of AI.\n\n\u003c!-- \u003e Explore data with SQL and AI, together. --\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://app.getdory.dev\"\u003e\u003cb\u003e🚀 Try Live Demo\u003c/b\u003e\u003c/a\u003e \u0026nbsp; • \u0026nbsp;\n  \u003ca href=\"#install-on-macos-with-homebrew\"\u003e\u003cb\u003e🍺 Install via Homebrew\u003c/b\u003e\u003c/a\u003e \u0026nbsp; • \u0026nbsp;\n  \u003ca href=\"https://github.com/dorylab/dory/releases\"\u003e\u003cb\u003e🍎 Download for macOS\u003c/b\u003e\u003c/a\u003e \u0026nbsp; • \u0026nbsp;\n  \u003ca href=\"https://github.com/dorylab/dory/releases\"\u003e\u003cb\u003eDownload for Windows\u003c/b\u003e\u003c/a\u003e \u0026nbsp; • \u0026nbsp;\n  \u003ca href=\"#quick-start\"\u003e\u003cb\u003e📦 Quick Start\u003c/b\u003e\u003c/a\u003e \u0026nbsp; • \u0026nbsp;\n  \u003ca href=\"https://www.getdory.dev/docs/deploy/self-hosting\"\u003e\u003cb\u003e🏠 Self-Hosting\u003c/b\u003e\u003c/a\u003e \u0026nbsp; • \u0026nbsp;\n  \u003ca href=\"./docs/contributing.md\"\u003e\u003cb\u003e🤝 Contributing\u003c/b\u003e\u003c/a\u003e \u0026nbsp; • \u0026nbsp;\n  \u003ca href=\"https://github.com/dorylab/dory/stargazers\"\u003e\u003cb\u003e⭐ Star\u003c/b\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**No signup required. Click \"Enter as Demo\" to start instantly.**\n\n**👇 Live Playground: https://app.getdory.dev**\n\n![Dory Preview](./public/actions.png)\n\n## 🚀 Quick Start\n### Install on macOS with Homebrew\n\n```bash\nbrew install dorylab/dory/dory\n```\n\n### Run with Docker\n\nMake sure Docker is installed, then run:\n\n```bash\ndocker run -d --name dory \\\n  -p 3000:3000 \\\n  -e DS_SECRET_KEY=\"$(openssl rand -base64 32 | tr -d '\\n')\" \\\n  -e BETTER_AUTH_SECRET=\"$(openssl rand -hex 32)\" \\\n  -e BETTER_AUTH_URL=\"http://localhost:3000\" \\\n  -e DORY_AI_PROVIDER=openai \\\n  -e DORY_AI_MODEL=gpt-4o-mini \\\n  -e DORY_AI_API_KEY=your_api_key_here \\\n  -e DORY_AI_URL=https://api.openai.com/v1 \\\n  -e NEXT_PUBLIC_REQUIRE_EMAIL_VERIFICATION=false \\\n  -e DORY_INIT_USER_EMAIL=admin@getdory.dev \\\n  -e DORY_INIT_USER_PASSWORD=admin \\\n  dorylab/dory:latest\n```\n\nThen:\n\n`Username: admin@getdory.dev`\n\n`Password: admin`\n\nThe initial administrator account is controlled by `DORY_INIT_USER_EMAIL` and `DORY_INIT_USER_PASSWORD` in `.env`.\n\nTo enable email verification, set `RESEND_API_KEY` to a valid [resend](https://resend.com) key and `EMAIL_FROM` to a validated email.\n\n\n### Self-host with Docker Compose\n\nFor long-running self-hosted deployments, Docker Compose runs Dory with a dedicated PostgreSQL database and persistent volumes.\n\n```bash\ncp docker-compose.env.example .env\n# Edit .env and replace all placeholder secrets/passwords.\ndocker compose up -d\n```\n\nFor comprehensive self-hosting documentation, environment variables, and deployment guides, see the [Self-Hosting Documentation](https://www.getdory.dev/docs/deploy/self-hosting).\n\n\n## ✨ Key Features\n\n### 🧠 SQL Copilot\n\nAn AI assistant grounded in real database schema and current query context.\n\n- **Ask** — Generate SQL from natural language  \n- **Action** — Fix or rewrite the current SQL  \n- **Context** — Explain query logic and field semantics  \n\nAI that understands your database — not just text completion.\n\n---\n\n### ⌨️ Schema-Aware Autocomplete\n\n- SQL completion based on real database schema  \n- Suggests tables, columns, functions, and aliases  \n- Supports multi-table joins and subqueries  \n\n---\n\u003cimg alt=\"image\" src=\"https://github.com/user-attachments/assets/c1775613-5773-4552-a188-90442f8f82ad\" /\u003e\n\n### ✍️ Intelligent SQL Editor\n\n- Multi-tab SQL workspace with support for multiple result sets\n- Save and organize frequently used queries\n- AI-powered SQL Copilot for writing, explaining, and optimizing queries\n- Instant query visualization with built-in charts\n\n---\n\u003cimg alt=\"image\" src=\"https://github.com/user-attachments/assets/d3e0b7a7-8c16-44d0-b248-685f7e386b6b\" /\u003e\n\n### 💬 Database Chatbot\n\n- Built-in conversational AI assistant  \n- Automatically understands connected database schema  \n- Ask questions directly about tables and SQL  \n- Quickly locate field meanings and query ideas  \n\n---\n\u003c!-- \u003cimg alt=\"image\" src=\"https://github.com/user-attachments/assets/4397055f7c74-4505-90dc-8d822845b670\" /\u003e --\u003e\n\n### 🔗 Agent Access via MCP\n\n- Desktop MCP endpoint for local agent clients\n- No manual token copy/paste in the desktop app\n- Supports schema discovery, saved queries, read-only SQL, table previews, monitoring summaries, and analysis tools\n\n---\n\n### 📈 ClickHouse Monitoring (Deep Integration)\n\nA native observability interface designed specifically for ClickHouse.\n\n- Real-time metrics:\n  - Total queries  \n  - Slow queries  \n  - Error queries  \n  - Active users  \n- Query latency trends (P50 / P95)  \n- Query throughput trends (QPM)  \n- Multi-dimensional filtering:\n  - User  \n  - Database  \n  - Query type  \n  - Time range  \n\n---\n\n![Dory Preview](./public/monitor-overview.png)\n\n### 🔐 ClickHouse Privileges (Deep Integration)\n\nNative ClickHouse user and role management UI.\n\n- Create, edit, and delete database users  \n- Create roles and configure grant relationships  \n- Configure:\n  - Login username and password  \n  - Allowed host addresses  \n  - Granted roles and default roles  \n- Supports cluster-level privilege operations (On Cluster)  \n- No need to manually write GRANT / CREATE USER SQL  \n\n---\n\n## 🔌 Database Support\n\n| Database   | Status              |\n| ---------- | ------------------- |\n| ClickHouse | ✅ Deeply integrated |\n| PostgreSQL | ✅ Supported         |\n| Neon       | ✅ Supported         |\n| MySQL      | ✅ Supported         |\n| MariaDB    | ✅ Supported         |\n| SQLite     | ✅ Supported         |\n| DuckDB     | ✅ Supported         |\n| SQL Server | ✅ Supported         |\n| Oracle     | ✅ Supported         |\n| Snowflake  | 🚧 Planned           |\n\n---\n\n## 🧠 Supported AI Providers\n\nDory is built with a pluggable AI provider architecture.\nYou can freely switch between different model vendors by changing environment variables — no code changes required.\n\nCurrently supported providers:\n\n| Provider          | Env `DORY_AI_PROVIDER` | Description                                           |\n| ----------------- | ---------------------- | ----------------------------------------------------- |\n| OpenAI            | `openai`               | Default provider. Uses official OpenAI API.           |\n| OpenAI-Compatible | `openai-compatible`    | Any service exposing an OpenAI-compatible API.        |\n| Anthropic         | `anthropic`            | Claude models via Anthropic official API.             |\n| Google            | `google`               | Gemini models via Google Generative AI API.           |\n| Qwen (Alibaba)    | `qwen`                 | Qwen models via DashScope OpenAI-compatible endpoint. |\n| xAI               | `xai`                  | Grok models via xAI API.                              |\n\n---\n\n## 🔗 Desktop MCP\n\nThe Dory desktop app includes local MCP (Model Context Protocol) support, so agent clients can use your Dory connections without manually copying API tokens.\n\nTo enable it:\n\n1. Open the Dory desktop app.\n2. Go to **Settings → Agent Access**.\n3. Turn on **Enable**.\n4. Add the displayed local endpoint to your MCP client.\n\nBy default, desktop MCP runs at:\n\n```text\nhttp://127.0.0.1:3318/api/mcp\n```\n\nFor Codex CLI:\n\n```bash\ncodex mcp add dory --url http://127.0.0.1:3318/api/mcp\ncodex mcp list\n```\n\nFor Claude Code:\n\n```bash\nclaude mcp add --transport http dory http://127.0.0.1:3318/api/mcp\nclaude mcp list\n```\n\nDory manages the desktop MCP grant automatically. The local MCP endpoint can list connections, inspect schemas, read saved queries, preview tables, run read-only SQL, and build analysis context for connected databases.\n\n---\n\n## 🗺️ Roadmap\n\nSee the latest roadmap here:\n\n\u003ca href=\"https://github.com/dorylab/dory/discussions/35\" target=\"_blank\" rel=\"noopener noreferrer\"\u003eDory Roadmap\u003c/a\u003e\n\n---\n\n## ⚙️ Tech Stack\n\n- Next.js + React + Tailwind\n- Drizzle ORM  \n- Multi-model AI SDK integration\n- PGLite\n- Resend\n- Shadcn UI\n- Monaco Editor\n\n---\n\n## 🎯 Who is it for?\n\n- Data engineers  \n- Data analysts  \n- Database platform teams  \n- ClickHouse operations teams  \n\n---\n\n\u003ch3\u003e\nYour data stays yours.\nExcept for AI requests sent through Cloudflare Gateway,\neverything — connections, tabs, and saved queries — is stored locally on your device.\n\u003ch3\u003e\n\n## 📄 License\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdorylab%2Fdory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdorylab%2Fdory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdorylab%2Fdory/lists"}