{"id":13715933,"url":"https://github.com/zilliztech/attu","last_synced_at":"2026-04-08T08:01:49.503Z","repository":{"id":39592312,"uuid":"436551874","full_name":"zilliztech/attu","owner":"zilliztech","description":"The Best GUI for Milvus","archived":false,"fork":false,"pushed_at":"2026-02-28T04:01:51.000Z","size":30794,"stargazers_count":2686,"open_issues_count":60,"forks_count":200,"subscribers_count":20,"default_branch":"main","last_synced_at":"2026-03-08T03:48:32.808Z","etag":null,"topics":["attu","milvus","vector-database"],"latest_commit_sha":null,"homepage":"https://github.com/zilliztech/attu","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"milvus-io/milvus-insight","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zilliztech.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2021-12-09T09:15:33.000Z","updated_at":"2026-03-07T20:59:56.000Z","dependencies_parsed_at":"2023-01-31T17:31:20.183Z","dependency_job_id":"53928048-645c-49d2-a203-05ff03b13bfe","html_url":"https://github.com/zilliztech/attu","commit_stats":null,"previous_names":[],"tags_count":79,"template":false,"template_full_name":null,"purl":"pkg:github/zilliztech/attu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zilliztech%2Fattu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zilliztech%2Fattu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zilliztech%2Fattu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zilliztech%2Fattu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zilliztech","download_url":"https://codeload.github.com/zilliztech/attu/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zilliztech%2Fattu/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31545907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"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":["attu","milvus","vector-database"],"created_at":"2024-08-03T00:01:05.195Z","updated_at":"2026-04-08T08:01:49.497Z","avatar_url":"https://github.com/zilliztech.png","language":"Shell","funding_links":[],"categories":["Data Integration \u0026 Migration","*Ops for AI","By Industry","Others","By Language","Shell","miscellaneous","Research \u0026 Data Analysis"],"sub_categories":["Model Serving \u0026 Inference","Other","TypeScript"],"readme":"# Attu — The AI Workbench for Milvus\n\n![GitHub release](https://img.shields.io/github/v/release/zilliztech/attu)\n[![Docker pulls](https://img.shields.io/docker/pulls/zilliz/attu)](https://hub.docker.com/r/zilliz/attu/tags)\n![GitHub stars](https://img.shields.io/github/stars/zilliztech/attu)\n[![中文](https://img.shields.io/badge/README-中文-blue.svg)](./README_CN.md)\n\nAttu is a modern, AI-native management tool for [Milvus](https://milvus.io) vector databases. Connect to multiple Milvus clusters from a single instance — manage schemas, explore data, run vector searches, monitor health, and automate tasks with a built-in AI agent.\n\nAvailable as a **web app** (Docker / Kubernetes) or **desktop app** (macOS, Linux, Windows).\n\n![Attu Home](.github/images/v3/01-home.png)\n\n---\n\n## What's New in v3\n\nAttu v3 is a ground-up rewrite with a modern full-stack architecture (React 19, TanStack Start, Vite).\n\n- **Multi-Cluster Management** — Connect to and switch between multiple Milvus instances from a single Attu deployment. Each connection maintains its own context, agent sessions, and preferences.\n- **AI Agent** — Chat-driven Milvus management with 50+ tools. Supports OpenAI, Anthropic, DeepSeek, Google Gemini, and custom endpoints.\n- **REST API Playground** — Interactive API editor with collection-scoped context.\n- **Backup \u0026 Restore** — Full and incremental backups with S3, MinIO, GCS, and Azure Blob support.\n- **Prometheus Metrics Dashboard** — 16+ real-time metrics with sparkline visualizations.\n- **Cluster Topology** — Interactive node visualization powered by ReactFlow.\n- **Slow Request Analysis** — Identify and diagnose slow queries across nodes.\n- **Desktop App with Auto-Update** — Native Electron app with automatic update delivery.\n- **Dark Mode** — Full light/dark theme support.\n\n---\n\n## Quick Start\n\n### Docker (recommended)\n\n```bash\ndocker run -d --name attu \\\n  -p 3000:3000 \\\n  -e MILVUS_ADDRESS=host.docker.internal:19530 \\\n  -v attu-data:/data \\\n  zilliz/attu:v3.0.0-beta.1\n```\n\nOpen http://localhost:3000.\n\n### Docker Compose (Milvus + Attu)\n\n```yaml\nservices:\n  milvus:\n    image: milvusdb/milvus:latest\n    ports:\n      - \"19530:19530\"\n      - \"9091:9091\"\n    command: milvus run standalone\n    volumes:\n      - milvus-data:/var/lib/milvus\n\n  attu:\n    image: zilliz/attu:v3.0.0-beta.1\n    ports:\n      - \"3000:3000\"\n    environment:\n      - MILVUS_ADDRESS=milvus:19530\n    volumes:\n      - attu-data:/data\n    depends_on:\n      - milvus\n\nvolumes:\n  milvus-data:\n  attu-data:\n```\n\n```bash\ndocker compose up -d\n```\n\n### Desktop App\n\nDownload the latest release for your platform:\n\n| Platform | Download |\n|----------|----------|\n| macOS (Apple Silicon) | [.dmg](https://github.com/zilliztech/attu/releases/latest) |\n| Linux | [.AppImage](https://github.com/zilliztech/attu/releases/latest) / [.deb](https://github.com/zilliztech/attu/releases/latest) |\n| Windows | [.exe](https://github.com/zilliztech/attu/releases/latest) |\n\n\u003e **macOS note:** If you see \"attu.app is damaged and cannot be opened\", run:\n\u003e ```bash\n\u003e sudo xattr -rd com.apple.quarantine /Applications/Attu.app\n\u003e ```\n\n---\n\n## Features\n\n### Multi-Cluster Management\n\nConnect to multiple Milvus instances from a single Attu deployment. Add, edit, and switch between connections in the sidebar. Each cluster has its own dedicated workspace with independent monitoring, agent sessions, and preferences — ideal for managing dev, staging, and production environments side by side.\n\n### Data Explorer\n\nBrowse databases and collections, view and edit data inline, import/export in CSV, JSON, and Parquet formats.\n\n![Explorer](.github/images/v3/03-explorer.png)\n\n### Vector Search\n\nInteractive vector similarity search with configurable embedding providers (OpenAI, Cohere, Jina, VoyageAI, and more).\n\n![Search](.github/images/v3/19-collection-search.png)\n\n### AI Agent\n\nChat-driven Milvus management with 50+ tools. Create collections, run queries, manage users, analyze performance — all through natural language.\n\nSupports: OpenAI, Anthropic Claude, DeepSeek, Google Gemini, OpenRouter, and custom API endpoints.\n\n![Agent](.github/images/v3/16-agent.png)\n\n### Cluster Overview \u0026 Monitoring\n\nReal-time cluster health, Prometheus metrics dashboard with 16+ metrics, and interactive topology visualization.\n\n![Overview](.github/images/v3/02-overview.png)\n\n![Metrics](.github/images/v3/06-metrics.png)\n\n![Topology](.github/images/v3/07-topology.png)\n\n### Backup \u0026 Restore\n\nFull and incremental backups with support for S3, MinIO, GCS, and Azure Blob Storage. Download backups as ZIP or restore from uploaded archives.\n\n![Backups](.github/images/v3/13-backups.png)\n\n### REST API Playground\n\nInteractive API testing environment scoped to your connection, database, and collection.\n\n![Playground](.github/images/v3/14-playground.png)\n\n### And More\n\n- **RBAC Management** — Create and manage users, roles, and privilege groups.\n- **Resource Groups** — Configure resource allocation across nodes.\n- **Slow Request Analysis** — Identify bottlenecks with cluster-wide slow query inspection.\n- **Configuration \u0026 Environment Viewer** — Inspect runtime configs and environment variables.\n- **Task Queue** — Monitor background operations (imports, backups, compactions).\n- **Internationalization** — English and Chinese language support.\n\n---\n\n## Deployment\n\n### Environment Variables\n\n| Variable | Example | Description |\n|----------|---------|-------------|\n| `MILVUS_ADDRESS` | `milvus:19530` | Milvus gRPC endpoint |\n| `MILVUS_NAME` | `My Cluster` | Display name in the connection list |\n| `MILVUS_DATABASE` | `default` | Default database |\n| `MILVUS_USERNAME` | `root` | Auth username |\n| `MILVUS_PASSWORD` | `milvus` | Auth password |\n| `MILVUS_TOKEN` | `token` | Auth token (alternative to username/password) |\n| `MILVUS_SSL` | `true` | Enable TLS connection |\n| `PORT` | `3000` | Server listen port (default: 3000) |\n| `ATTU_DB_PATH` | `/data/attu.db` | SQLite database path for connections and preferences |\n\nWhen `MILVUS_ADDRESS` is set, Attu will automatically create a connection on first launch.\n\n\u003e **Note:** `MILVUS_ADDRESS` must be reachable from the Attu container. `127.0.0.1` or `localhost` will not work — use the container/service name or `host.docker.internal`.\n\n### TLS / SSL\n\nMount your certificate files and set the corresponding environment variables:\n\n```bash\ndocker run -d --name attu \\\n  -p 3000:3000 \\\n  -v /path/to/certs:/certs \\\n  -e MILVUS_ADDRESS=milvus:19530 \\\n  -e MILVUS_SSL=true \\\n  zilliz/attu:v3.0.0-beta.1\n```\n\n### Kubernetes\n\n```bash\nkubectl apply -f https://raw.githubusercontent.com/zilliztech/attu/main/deploy/attu-k8s-deploy.yaml\n```\n\nEdit the YAML to set `MILVUS_ADDRESS` to your Milvus service name (e.g., `my-release-milvus:19530`).\n\n### Nginx Reverse Proxy\n\nSee the [nginx deployment guide](https://github.com/zilliztech/attu/tree/main/deploy/nginx).\n\n---\n\n## Compatibility\n\n| Milvus Version | Attu Version |\n|----------------|-------------|\n| 2.5.x – 2.6.x | [v3.0.0-beta.1](https://github.com/zilliztech/attu/releases/tag/v3.0.0-beta.1) |\n| 2.6.x | [v2.6.5](https://github.com/zilliztech/attu/releases/tag/v2.6.5) |\n| 2.5.x | [v2.5.10](https://github.com/zilliztech/attu/releases/tag/v2.5.10) |\n| 2.4.x | [v2.4.12](https://github.com/zilliztech/attu/releases/tag/v2.4.12) |\n| 2.3.x | [v2.3.5](https://github.com/zilliztech/attu/releases/tag/v2.3.5) |\n\n---\n\n## FAQ\n\n**I can't connect to Milvus from Docker**\n\u003e Make sure `MILVUS_ADDRESS` is reachable from inside the container. Use the Docker service name, not `localhost`. See [#161](https://github.com/zilliztech/attu/issues/161).\n\n**macOS says the app is damaged**\n\u003e Run `sudo xattr -rd com.apple.quarantine /Applications/Attu.app` in Terminal.\n\n**How do I update?**\n\u003e Docker: pull the latest image and restart. Desktop: the app checks for updates automatically on launch.\n\n---\n\n## Resources\n\n- [Milvus Documentation](https://milvus.io/docs)\n- [Milvus Python SDK](https://github.com/milvus-io/pymilvus)\n- [Milvus Java SDK](https://github.com/milvus-io/milvus-sdk-java)\n- [Milvus Go SDK](https://github.com/milvus-io/milvus-sdk-go)\n- [Milvus Node.js SDK](https://github.com/milvus-io/milvus-sdk-node)\n\n## Community\n\nJoin the [Milvus Discord](https://discord.com/invite/8uyFbECzPX) to ask questions, share feedback, and connect with other users.\n\n## License\n\nAttu was open source under the Apache License 2.0 through version v2.5.12. Starting from version v2.6.0, Attu is proprietary software. See [LICENSE_PROPRIETARY.txt](./LICENSE_PROPRIETARY.txt) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzilliztech%2Fattu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzilliztech%2Fattu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzilliztech%2Fattu/lists"}