vecmindb 1.0.0b0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. vecmindb/__init__.py +163 -0
  2. vecmindb/async_client.py +1074 -0
  3. vecmindb/auth.py +188 -0
  4. vecmindb/client.py +748 -0
  5. vecmindb/exceptions.py +135 -0
  6. vecmindb/integrations/__init__.py +1 -0
  7. vecmindb/integrations/langchain.py +172 -0
  8. vecmindb/integrations/llamaindex.py +156 -0
  9. vecmindb/mcp.py +515 -0
  10. vecmindb/mcp_server.py +138 -0
  11. vecmindb/memory.py +329 -0
  12. vecmindb/memory_plugin.py +254 -0
  13. vecmindb/models.py +469 -0
  14. vecmindb/py.typed +1 -0
  15. vecmindb/retry.py +179 -0
  16. vecmindb-1.0.0b0.dist-info/METADATA +143 -0
  17. vecmindb-1.0.0b0.dist-info/RECORD +19 -0
  18. vecmindb-1.0.0b0.dist-info/WHEEL +5 -0
  19. vecmindb-1.0.0b0.dist-info/top_level.txt +1 -0
vecmindb/__init__.py ADDED
@@ -0,0 +1,163 @@
1
+ """VecminDB Python SDK – Commercial-Grade Vector Database Client.
2
+
3
+ Provides both synchronous and asynchronous clients for the VecminDB REST API,
4
+ along with an MCP (Model Context Protocol) client for AI agent integration.
5
+
6
+ Quick start::
7
+
8
+ from vecmindb import VecminClient, AsyncVecminClient
9
+
10
+ # Synchronous
11
+ with VecminClient("http://localhost:5520", api_key="xxx") as client:
12
+ client.create_collection("docs", dimension=1536)
13
+
14
+ # Asynchronous
15
+ async with AsyncVecminClient("http://localhost:5520", api_key="xxx") as client:
16
+ await client.create_collection("docs", dimension=1536)
17
+ """
18
+
19
+ from .client import VecminClient
20
+ from .async_client import AsyncVecminClient
21
+ from .mcp import McpClient, SyncMcpClient
22
+ from .exceptions import (
23
+ VecminError,
24
+ AuthenticationError,
25
+ PermissionError,
26
+ PaymentRequiredError,
27
+ NotFoundError,
28
+ BadRequestError,
29
+ ConflictError,
30
+ ValidationError,
31
+ RateLimitError,
32
+ ServerError,
33
+ ConnectionError,
34
+ TimeoutError,
35
+ )
36
+ from .models import (
37
+ VecminResponse,
38
+ CreateCollectionRequest,
39
+ CollectionInfo,
40
+ CollectionStats,
41
+ InsertRequest,
42
+ BatchInsertRequest,
43
+ SearchRequest,
44
+ SearchHit,
45
+ SearchResponse,
46
+ CreateVectorRequest,
47
+ BatchCreateVectorsRequest,
48
+ BatchDeleteVectorsRequest,
49
+ IndexInfo,
50
+ ShadowTrajectoryPoint,
51
+ ClusterLoginRequest,
52
+ ClusterLoginResponse,
53
+ ClusterJoinRequest,
54
+ ClusterPromoteRequest,
55
+ ClusterNodeInfo,
56
+ ClusterStatus,
57
+ SnapshotInfo,
58
+ SnapshotRequest,
59
+ HealthStatus,
60
+ SubsystemStatus,
61
+ GlobalStats,
62
+ McpToolCall,
63
+ McpStoreMemoryParams,
64
+ McpSearchMemoryParams,
65
+ McpInitializeParams,
66
+ )
67
+ from .auth import AuthManager
68
+ from .retry import RetryConfig
69
+ from .memory_plugin import VecminDBMemoryPlugin
70
+ from .memory import (
71
+ AgentMemoryManager,
72
+ AsyncAgentMemoryManager,
73
+ VecminMemorySpace,
74
+ AsyncVecminMemorySpace,
75
+ )
76
+ from typing import Optional
77
+
78
+ __version__ = "1.0.0-beta"
79
+
80
+
81
+ def connect(
82
+ base_url: str = "http://localhost:5520",
83
+ *,
84
+ api_key: Optional[str] = None,
85
+ jwt_token: Optional[str] = None,
86
+ admin_password: Optional[str] = None,
87
+ agent_id: Optional[str] = None,
88
+ sovereignty_token: Optional[str] = None,
89
+ **kwargs,
90
+ ) -> VecminClient:
91
+ """Convenience function to connect to VecminDB and return a sync client."""
92
+ return VecminClient(
93
+ base_url=base_url,
94
+ api_key=api_key,
95
+ jwt_token=jwt_token,
96
+ admin_password=admin_password,
97
+ agent_id=agent_id,
98
+ sovereignty_token=sovereignty_token,
99
+ **kwargs,
100
+ )
101
+
102
+
103
+ __all__ = [
104
+ # Clients
105
+ "VecminClient",
106
+ "AsyncVecminClient",
107
+ "McpClient",
108
+ "SyncMcpClient",
109
+ "connect",
110
+ # Exceptions
111
+ "VecminError",
112
+ "AuthenticationError",
113
+ "PermissionError",
114
+ "PaymentRequiredError",
115
+ "NotFoundError",
116
+ "BadRequestError",
117
+ "ConflictError",
118
+ "ValidationError",
119
+ "RateLimitError",
120
+ "ServerError",
121
+ "ConnectionError",
122
+ "TimeoutError",
123
+ # Models
124
+ "VecminResponse",
125
+ "CreateCollectionRequest",
126
+ "CollectionInfo",
127
+ "CollectionStats",
128
+ "InsertRequest",
129
+ "BatchInsertRequest",
130
+ "SearchRequest",
131
+ "SearchHit",
132
+ "SearchResponse",
133
+ "CreateVectorRequest",
134
+ "BatchCreateVectorsRequest",
135
+ "BatchDeleteVectorsRequest",
136
+ "IndexInfo",
137
+ "ShadowTrajectoryPoint",
138
+ "ClusterLoginRequest",
139
+ "ClusterLoginResponse",
140
+ "ClusterJoinRequest",
141
+ "ClusterPromoteRequest",
142
+ "ClusterNodeInfo",
143
+ "ClusterStatus",
144
+ "SnapshotInfo",
145
+ "SnapshotRequest",
146
+ "HealthStatus",
147
+ "SubsystemStatus",
148
+ "GlobalStats",
149
+ "McpToolCall",
150
+ "McpStoreMemoryParams",
151
+ "McpSearchMemoryParams",
152
+ "McpInitializeParams",
153
+ # Auth & Retry
154
+ "AuthManager",
155
+ "RetryConfig",
156
+ # Memory Plugin
157
+ "VecminDBMemoryPlugin",
158
+ # Agent OS Memory Managers
159
+ "AgentMemoryManager",
160
+ "AsyncAgentMemoryManager",
161
+ "VecminMemorySpace",
162
+ "AsyncVecminMemorySpace",
163
+ ]