How weaviate/weaviate-python-client works
The Weaviate Python client lets applications connect to a Weaviate instance, manage collections and objects, and retrieve results through synchronous or asynchronous APIs. The principal workflow is to create a client, define or select a collection, then write or query data; the client connection layer handles transport and authentication. Separate API branches expose batching, backups, exports, cluster operations, and administration. The README establishes the product purpose; component links use the supplied source index and excerpts, so some unsampled subsystem internals are not detailed.
Main entry points: client.py Client API · client_executor.py Client runtime · v4.py Connection · base.py Collection API
Components 21
Client and transport
- Client API
weaviate/client.py - Client runtime
weaviate/client_executor.py - Connection
weaviate/connect/v4.py - Sync/async executor
weaviate/connect/executor.py - Authentication
weaviate/connect/authentication.py
Collections and data
- Collection API
weaviate/collections/collection/base.py - Collection management
weaviate/collections/collections/base.py - Collection configuration
weaviate/collections/config/executor.py
Data operations
- Object data
weaviate/collections/data/executor.py - Query API
weaviate/collections/query.py - gRPC query
weaviate/collections/grpc/query.py - Batching
weaviate/collections/batch/client.py - Backups
weaviate/backup/executor.py - Exports
weaviate/export/executor.py
Administration
- Cluster operations
weaviate/cluster/base.py - Roles and permissions
weaviate/rbac/executor.py - User management
weaviate/users/base.py - Group management
weaviate/groups/base.py - Tokenization
weaviate/tokenization/executor.py
Other components
- Application
- Weaviate instance
Connections 20
- Application → Client API: creates client
weaviate/client.py - Client API → Client runtime: inherits runtime
weaviate/client.py - Client runtime → Connection: uses connection
weaviate/client_executor.py - Client runtime → Sync/async executor: dispatches calls
weaviate/client_executor.py - Connection → Authentication: uses auth
weaviate/connect/v4.py - Connection → Weaviate instance: sends requests
- Client API → Collection API: exposes collections
weaviate/client.py - Client API → Collection management: exposes management
weaviate/client.py - Client API → Batching: exposes batching
weaviate/client.py - Client API → Backups: exposes backups
weaviate/client.py - Client API → Exports: exposes exports
weaviate/client.py - Client API → Cluster operations: exposes cluster
weaviate/client.py - Client API → Roles and permissions: exposes roles
weaviate/client.py - Client API → User management: exposes users
weaviate/client.py - Client API → Group management: exposes groups
weaviate/client.py - Client API → Collection configuration: exposes configuration
- Collection API → Object data: accesses objects
- Collection API → Query API: offers queries
- Query API → gRPC query: executes queries
- Client API → Tokenization: exposes tokenization