# Install weaviate-cli with Homebrew Command-line interface for managing and interacting with Weaviate. Version 3.4.1 via Homebrew; verified 2026-06-27. ## Install ```sh sudo av install brew:weaviate-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install weaviate-cli ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:weaviate-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.4.1 - **Source summary:** Command-line interface for managing and interacting with Weaviate - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** BSD-3-Clause - **Source archive:** - **Last updated:** 2026-06-27T19:01:12Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - weaviate-cli (cli) - weaviate-cli (alias) ## Dependencies - certifi - cryptography - numpy - openssl@3 - pillow - pydantic - python@3.14 ## Build dependencies - cmake - meson - ninja - pkgconf ## Uses from macOS - libffi ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 3.4.1 - Package-manager updated: 2026-06-27 - Local data: ok - Upstream repository: https://pypi.org/project/weaviate-cli/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage Weaviate CLI is the command-line interface for managing and interacting with Weaviate vector databases from a terminal. It wraps database-administration and data workflows such as collection management, import, querying, multi-tenancy, backups, sharding, and role management. The CLI belongs to the Weaviate ecosystem, where the underlying database is an open-source vector database for semantic search, hybrid search, retrieval-augmented generation, recommendations, chatbots, and related AI application patterns. ### Project history The PyPI release history shows that weaviate-cli began with early 0.0.x releases in May 2019. That places the CLI close to the early public period of Weaviate as an open-source vector search/database project. The project appears to have gone through a quiet or unsupported period: in February 2024, a Weaviate community forum response said the weaviate-cli tool was not under development anymore. Later PyPI metadata shows a renewed 3.x release line, with 3.3.0 in January 2026, 3.4.0 in April 2026, and 3.4.1 in May 2026. The current README describes a modern Python 3.10-plus CLI with commands for collections, data, tenants, backups, replication, shard status, query types, and role assignment. It also documents Homebrew installation and a JSON configuration file under ~/.config/weaviate/config.json. ### Adoption history The CLI's adoption is tied to Weaviate's shift from vector-search infrastructure into a mainstream AI application platform. Weaviate's own documentation describes the database, Weaviate Cloud, query agents, managed embeddings, and external model-provider integrations as parts of the product surface developers evaluate and operate. For operators and developers, the CLI is a lightweight administrative companion to SDKs, cloud consoles, Docker/Kubernetes deployments, and application code. It gives repeatable terminal commands for tasks that otherwise require custom scripts or UI interaction. ### How it is used Common usage includes creating a collection, importing test or application data, running vector, keyword, or hybrid queries, changing tenant state, starting backups to S3, GCS, or filesystem backends, restoring backups, inspecting shards, and assigning or revoking roles. Configuration is file-based by default. The README says the CLI looks for ~/.config/weaviate/config.json, can create default localhost settings, and can store remote host, gRPC host, API-key authentication, per-user authentication entries, and provider headers such as OpenAI, Cohere, or Jina keys. ### Why package nerds care weaviate-cli is significant as the shell entry point for a vector database ecosystem. It packages database-management operations into commands that can be used in demos, CI scripts, local development, and operational runbooks for AI search or RAG systems. Its history also shows the churn around fast-moving AI infrastructure: an early CLI, a period where community support described it as inactive, and a later 3.x line matching the renewed need for command-line management of vector-database deployments. ### Timeline - 2019-05-21: PyPI records weaviate-cli 0.0.3, the earliest listed release. - 2024-02-02: A Weaviate forum response says the older weaviate-cli tool is not under development anymore. - 2025-2026: PyPI shows renewed 3.x releases. - 2026-05-08: PyPI records weaviate-cli 3.4.1, the latest release observed during this enrichment run. ### Related projects - Weaviate CLI is related to Weaviate Database, Weaviate Cloud, the Weaviate Python client, Docker and Kubernetes Weaviate deployments, vector search engines, RAG frameworks, and model-provider integrations such as OpenAI, Cohere, and Jina. ### Sources - - - - - - ## Security Notes No matching local secret-handling manifest was found for weaviate-cli. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/weaviate/config.json ## Credential files - Unix: ~/.config/weaviate/config.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** weaviate-cli - **Version Scheme:** 0 - **Revision:** 2 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [numpy](https://www.automicvault.com/pkg/brew/numpy/) - Runtime dependency declared by Homebrew. - [openssl@3](https://www.automicvault.com/pkg/brew/openssl-3/) - Runtime dependency declared by Homebrew. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew. - [meson](https://www.automicvault.com/pkg/brew/meson/) - Build dependency declared by Homebrew. - [ninja](https://www.automicvault.com/pkg/brew/ninja/) - Build dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [weaviate](https://www.automicvault.com/pkg/brew/weaviate/) - Package name indicates the same formula family. - [percol](https://www.automicvault.com/pkg/brew/percol/) - Shares av.db curated category or tags: cli, developer-tools, python. - [pyp](https://www.automicvault.com/pkg/brew/pyp/) - Shares av.db curated category or tags: cli, developer-tools, python. - [python-argcomplete](https://www.automicvault.com/pkg/brew/python-argcomplete/) - Shares av.db curated category or tags: cli, developer-tools, python. - [rich-cli](https://www.automicvault.com/pkg/brew/rich-cli/) - Shares av.db curated category or tags: cli, developer-tools, python. - [abi3audit](https://www.automicvault.com/pkg/brew/abi3audit/) - Shares av.db curated category or tags: cli, developer-tools, python. - [auditwheel](https://www.automicvault.com/pkg/brew/auditwheel/) - Shares av.db curated category or tags: cli, developer-tools, python. - [austin](https://www.automicvault.com/pkg/brew/austin/) - Shares av.db curated category or tags: cli, developer-tools, python. - [autopep8](https://www.automicvault.com/pkg/brew/autopep8/) - Shares av.db curated category or tags: cli, developer-tools, python. - [waybackpy](https://www.automicvault.com/pkg/brew/waybackpy/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, command-line, developer, developer-tools. - [langgraph-cli](https://www.automicvault.com/pkg/brew/langgraph-cli/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, command-line, developer, developer-tools. - [notifiers](https://www.automicvault.com/pkg/brew/notifiers/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, developer, developer-tools, python. ## Combined YAML source View the package source record on GitHub. [combined/weaviate-cli.yml](https://github.com/automic-vault/db/blob/main/combined/weaviate-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph