{"id":50076841,"url":"https://github.com/zvec-ai/zvec-studio","last_synced_at":"2026-05-27T14:05:19.695Z","repository":{"id":359259262,"uuid":"1245234058","full_name":"zvec-ai/zvec-studio","owner":"zvec-ai","description":"visual management tool for zvec","archived":false,"fork":false,"pushed_at":"2026-05-21T08:41:49.000Z","size":1482,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-21T09:57:59.288Z","etag":null,"topics":["fastapi","react","tauri","ui","uvicorn","zvec"],"latest_commit_sha":null,"homepage":"https://zvec.org/en/","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/zvec-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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-05-21T03:19:11.000Z","updated_at":"2026-05-21T08:41:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zvec-ai/zvec-studio","commit_stats":null,"previous_names":["zvec-ai/zvec-studio"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/zvec-ai/zvec-studio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvec-ai%2Fzvec-studio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvec-ai%2Fzvec-studio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvec-ai%2Fzvec-studio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvec-ai%2Fzvec-studio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zvec-ai","download_url":"https://codeload.github.com/zvec-ai/zvec-studio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvec-ai%2Fzvec-studio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33568904,"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-27T02:00:06.184Z","response_time":53,"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":["fastapi","react","tauri","ui","uvicorn","zvec"],"created_at":"2026-05-22T08:11:37.715Z","updated_at":"2026-05-27T14:05:19.690Z","avatar_url":"https://github.com/zvec-ai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"right\"\u003e\n  English | \u003ca href=\"https://github.com/zvec-ai/zvec-studio/blob/main/README.zh-CN.md\"\u003e中文\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/zvec-ai/zvec-studio/main/docs/assets/hero-dark.svg\" /\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/zvec-ai/zvec-studio/main/docs/assets/hero-light.svg\" width=\"480\" alt=\"Zvec Studio\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eVisual management tool for the \u003ca href=\"https://github.com/alibaba/zvec\"\u003eZvec\u003c/a\u003e embedded vector database\u003c/strong\u003e\u003cbr/\u003e\n  Browse data, test queries, and manage schemas — without writing code.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/zvec-ai/zvec-studio/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Apache%202.0-blue.svg\" alt=\"License\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/zvec-studio/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/zvec-studio?color=blue\u0026label=version\" alt=\"Version\"/\u003e\u003c/a\u003e\n  \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-3DDC84\" alt=\"Platforms\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/zvec-ai/zvec-studio/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/zvec-ai/zvec-studio/actions/workflows/ci.yml/badge.svg?branch=main\" alt=\"CI\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/zvec-ai/zvec-studio/main/docs/assets/tour-guide.gif\" width=\"720\" alt=\"Zvec Studio guided tour\" /\u003e\n\u003c/p\u003e\n\n---\n\n## 📦 Installation\n\n### Option 1: pip (recommended for developers)\n\nRequires Python 3.10 – 3.14.\n\n```bash\npip install zvec-studio\nzvec-studio\n```\n\nOpens http://127.0.0.1:7860 in your browser.\n\n\u003e **Need embedding \u0026 reranking?** Install with the `[ai]` extra to enable built-in embedding \u0026 reranking functions:\n\u003e\n\u003e ```bash\n\u003e pip install zvec-studio[ai]\n\u003e ```\n\n### Option 2: Desktop download (experimental)\n\nGrab the installer for your platform from [GitHub Releases](https://github.com/zvec-ai/zvec-studio/releases):\n\n| Platform | Architectures | Installer |\n|----------|---------------|-----------|\n| macOS | Apple Silicon (arm64) | `.dmg` |\n| Linux | x86_64, arm64 | `.deb` / `.AppImage` |\n| Windows | x86_64 | `.msi` / `.exe` |\n\nDouble-click to run — no Python needed.\n\n### Option 3: From source\n\n```bash\ngit clone https://github.com/zvec-ai/zvec-studio.git\ncd zvec-studio\nmake install    # install Node + Python dependencies\nmake dev        # starts backend + frontend dev servers\n```\n\n\u003e **Need embedding \u0026 reranking?** `make install` does NOT install AI runtime\n\u003e dependencies (`sentence-transformers`, `dashscope`, etc.) to keep CI fast. Run\n\u003e `make install.ai` instead if you want to use built-in functions like\n\u003e `local-dense`, `bm25`, or `dashscope`.\n\n\u003e Prerequisites: **Node.js ≥ 20**, **pnpm ≥ 9**, **Python ≥ 3.10**, **Rust** (desktop only).\n\u003e See [Contributing](https://github.com/zvec-ai/zvec-studio/blob/main/CONTRIBUTING.md) for the full dev setup guide.\n\n## ⚡ Quick Start\n\n1. **Create a collection** — Collections → Create. Define vector and scalar fields.\n2. **Insert data** — Paste JSON documents in the Write tab.\n3. **Vector search** — Paste a query vector in the Query tab, set TopK, hit Search.\n4. **AI search** — Register an embedding model, then search by typing text directly.\n\nFull walkthrough → [Getting Started](https://github.com/zvec-ai/zvec-studio/blob/main/docs/getting-started.md)\n\n## 📖 Documentation\n\n| | |\n|---|---|\n| [Getting Started](https://github.com/zvec-ai/zvec-studio/blob/main/docs/getting-started.md) | 10-minute walkthrough from install to first search |\n| [Architecture](https://github.com/zvec-ai/zvec-studio/blob/main/docs/architecture.md) | Request flow, module map, code index |\n| [API Reference](https://github.com/zvec-ai/zvec-studio/blob/main/docs/api.md) | REST endpoints, request/response formats, error codes |\n| [Testing](https://github.com/zvec-ai/zvec-studio/blob/main/docs/testing.md) | Test strategy, self-verification loop, performance baselines |\n| [Packaging](https://github.com/zvec-ai/zvec-studio/blob/main/docs/PACKAGING.md) | PyInstaller + Tauri cross-platform packaging |\n| [Contributing](https://github.com/zvec-ai/zvec-studio/blob/main/CONTRIBUTING.md) | Dev setup, code style, commit workflow |\n\n## 🗺️ Roadmap\n\n| Version | Focus |\n|---------|-------|\n| **v0.1.x** (current) | Collection CRUD, schema evolution, document ops, vector search, AI extension, i18n, desktop app |\n| **v0.2.x** | Data import/export, virtual scrolling, batch operations, advanced search |\n| **v0.3.x** | Vector visualization (UMAP/t-SNE), clustering, AI Agent, SDK code generation |\n| **v0.4.x** | VS Code extension, API Playground, webhooks \u0026 notifications |\n\n## 🤝 Contributing\n\nContributions welcome! See [CONTRIBUTING.md](https://github.com/zvec-ai/zvec-studio/blob/main/CONTRIBUTING.md) for details.\n\n```bash\nmake dev        # Start dev servers\nmake verify     # Lint + typecheck + tests\n```\n\n## 📄 License\n\n[Apache License 2.0](https://github.com/zvec-ai/zvec-studio/blob/main/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzvec-ai%2Fzvec-studio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzvec-ai%2Fzvec-studio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzvec-ai%2Fzvec-studio/lists"}