crowvault 2.0.0__tar.gz

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.
@@ -0,0 +1,195 @@
1
+ Metadata-Version: 2.4
2
+ Name: crowvault
3
+ Version: 2.0.0
4
+ Summary: CrowVault Python SDK — 325 AI-powered dev tools via one API. Zero dependencies.
5
+ Author-email: "TechSynergy Corp." <hello@crowvault.ai>
6
+ License: MIT
7
+ Project-URL: Homepage, https://crowvault.ai
8
+ Project-URL: Documentation, https://crowvault.ai/docs
9
+ Project-URL: Pricing, https://crowvault.ai/pricing
10
+ Project-URL: Contact, https://crowvault.ai/contact
11
+ Keywords: crowvault,mcp,ai,dev-tools,code-generation,schema,terraform,openapi,kubernetes,dockerfile,ddd,workflow,devops
12
+ Classifier: Development Status :: 5 - Production/Stable
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.9
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Software Development :: Code Generators
22
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
+ Requires-Python: >=3.9
24
+ Description-Content-Type: text/markdown
25
+
26
+ # crowvault
27
+
28
+ Python SDK for [CrowVault](https://crowvault.ai) — 325 AI-powered dev tools via one API. Zero dependencies.
29
+
30
+ ## Install
31
+
32
+ ```bash
33
+ pip install crowvault
34
+ ```
35
+
36
+ ## Quick Start
37
+
38
+ ```python
39
+ from crowvault import CrowVaultClient
40
+
41
+ client = CrowVaultClient(api_key="cv_your_key_here")
42
+
43
+ # Generate a database schema
44
+ result = client.call("database-mcp", "design_schema",
45
+ aggregate="Order", database="postgresql")
46
+ print(result.text)
47
+
48
+ # Generate a Dockerfile
49
+ result = client.call("devops-mcp", "generate_dockerfile",
50
+ runtime="node", version="20")
51
+ print(result.text)
52
+ ```
53
+
54
+ ## Authentication
55
+
56
+ ```python
57
+ # Option 1: Pass directly
58
+ client = CrowVaultClient(api_key="cv_...")
59
+
60
+ # Option 2: Environment variable
61
+ # export CROWVAULT_API_KEY=cv_...
62
+ client = CrowVaultClient()
63
+ ```
64
+
65
+ ## API Reference
66
+
67
+ ### Call a Tool
68
+
69
+ ```python
70
+ result = client.call("database-mcp", "design_schema",
71
+ aggregate="Order",
72
+ database="postgresql",
73
+ outputFormat="prisma")
74
+
75
+ print(result.text) # Generated code
76
+ print(result.success) # True/False
77
+ print(result.meta) # {server, tool, durationMs, ...}
78
+ ```
79
+
80
+ ### Call with Dict Args
81
+
82
+ Use `call_raw()` when arg names conflict with Python keywords:
83
+
84
+ ```python
85
+ result = client.call_raw("api-mcp", "generate_openapi_spec", {
86
+ "service": "users",
87
+ "version": "v1",
88
+ "format": "yaml", # "format" is a Python builtin
89
+ })
90
+ ```
91
+
92
+ ### List Servers & Tools
93
+
94
+ ```python
95
+ # All servers
96
+ servers = client.servers()
97
+ for s in servers:
98
+ print(f"{s['name']} — {s['toolCount']} tools")
99
+
100
+ # All tools (or filter)
101
+ tools = client.tools(server="database-mcp")
102
+ tools = client.tools(search="schema")
103
+ ```
104
+
105
+ ### Batch Execution
106
+
107
+ Execute up to 10 tools in parallel:
108
+
109
+ ```python
110
+ result = client.batch([
111
+ {"server": "database-mcp", "tool": "design_schema",
112
+ "args": {"aggregate": "Order", "database": "postgresql"}},
113
+ {"server": "devops-mcp", "tool": "generate_dockerfile",
114
+ "args": {"runtime": "node", "version": "20"}},
115
+ {"server": "devops-mcp", "tool": "generate_k8s_deployment",
116
+ "args": {"name": "order-service"}},
117
+ ])
118
+
119
+ print(f"{result.succeeded}/{len(result.results)} succeeded")
120
+ for r in result.results:
121
+ print(r.text[:100])
122
+ ```
123
+
124
+ ### Workflows
125
+
126
+ Run multi-step pipelines that chain tools together:
127
+
128
+ ```python
129
+ # List available workflows
130
+ workflows = client.workflows()
131
+ for wf in workflows:
132
+ print(f"{wf['id']} — {wf['stepCount']} steps")
133
+
134
+ # Run a workflow
135
+ result = client.run_workflow("microservice-scaffold",
136
+ name="orders",
137
+ language="node",
138
+ database="postgresql")
139
+
140
+ print(result) # Step-by-step summary
141
+ print(result.success)
142
+ print(result.total_duration_ms)
143
+
144
+ for step in result.results:
145
+ print(f"{step['tool']} — {step['durationMs']}ms")
146
+ ```
147
+
148
+ **Available workflows:**
149
+ - `microservice-scaffold` — Microservice + schema + migration + Docker + K8s (5 steps)
150
+ - `api-full-stack` — OpenAPI + endpoint + tests + contracts (4 steps)
151
+ - `ddd-complete` — Bounded context + model + aggregate + entity + repo + schema (6 steps)
152
+ - `event-driven` — Kafka + event handler + DLQ (3 steps)
153
+ - `deploy-stack` — Dockerfile + Compose + K8s + Helm (4 steps)
154
+ - `database-setup` — Schema + ORM + migration + seed (4 steps)
155
+
156
+ ## 9 Servers, 325 Tools
157
+
158
+ | Server | Tools | Coverage |
159
+ |--------|-------|----------|
160
+ | AWS | 53 | EC2, S3, Lambda, RDS, ECS, CloudFormation, IAM |
161
+ | GCP | 41 | Compute, GKE, Cloud Run, BigQuery, Pub/Sub |
162
+ | Full Stack | 38 | Express, NestJS, React, Vue, Next.js, FastAPI |
163
+ | Frontend | 36 | Components, state, routing, forms, accessibility |
164
+ | Database | 34 | PostgreSQL, MySQL, MongoDB, Prisma, migrations |
165
+ | Testing | 31 | Jest, Vitest, Cypress, load tests, mocks |
166
+ | Security | 31 | Auth, RBAC, encryption, OWASP, scanning |
167
+ | DevOps | 31 | Docker, K8s, Terraform, Helm, CI/CD, Prometheus |
168
+ | API | 30 | OpenAPI, GraphQL, gRPC, Kafka, webhooks, OAuth |
169
+
170
+ ## Error Handling
171
+
172
+ ```python
173
+ from crowvault import CrowVaultClient
174
+ from crowvault.client import CrowVaultError
175
+
176
+ client = CrowVaultClient()
177
+
178
+ try:
179
+ result = client.call("database-mcp", "design_schema",
180
+ aggregate="Order", database="postgresql")
181
+ print(result.text)
182
+ except CrowVaultError as e:
183
+ print(f"Error: {e} (HTTP {e.status})")
184
+ ```
185
+
186
+ ## Pricing
187
+
188
+ - **Free**: 50 calls/month, 2 API keys — [Sign up free](https://crowvault.ai/register?plan=free)
189
+ - **Developer**: $49/month, 1,000 calls, 5 keys
190
+ - **Team**: $199/month, 10,000 calls, 10 keys
191
+ - **Enterprise**: Custom
192
+
193
+ ## License
194
+
195
+ MIT. Copyright TechSynergy Corp.
@@ -0,0 +1,170 @@
1
+ # crowvault
2
+
3
+ Python SDK for [CrowVault](https://crowvault.ai) — 325 AI-powered dev tools via one API. Zero dependencies.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ pip install crowvault
9
+ ```
10
+
11
+ ## Quick Start
12
+
13
+ ```python
14
+ from crowvault import CrowVaultClient
15
+
16
+ client = CrowVaultClient(api_key="cv_your_key_here")
17
+
18
+ # Generate a database schema
19
+ result = client.call("database-mcp", "design_schema",
20
+ aggregate="Order", database="postgresql")
21
+ print(result.text)
22
+
23
+ # Generate a Dockerfile
24
+ result = client.call("devops-mcp", "generate_dockerfile",
25
+ runtime="node", version="20")
26
+ print(result.text)
27
+ ```
28
+
29
+ ## Authentication
30
+
31
+ ```python
32
+ # Option 1: Pass directly
33
+ client = CrowVaultClient(api_key="cv_...")
34
+
35
+ # Option 2: Environment variable
36
+ # export CROWVAULT_API_KEY=cv_...
37
+ client = CrowVaultClient()
38
+ ```
39
+
40
+ ## API Reference
41
+
42
+ ### Call a Tool
43
+
44
+ ```python
45
+ result = client.call("database-mcp", "design_schema",
46
+ aggregate="Order",
47
+ database="postgresql",
48
+ outputFormat="prisma")
49
+
50
+ print(result.text) # Generated code
51
+ print(result.success) # True/False
52
+ print(result.meta) # {server, tool, durationMs, ...}
53
+ ```
54
+
55
+ ### Call with Dict Args
56
+
57
+ Use `call_raw()` when arg names conflict with Python keywords:
58
+
59
+ ```python
60
+ result = client.call_raw("api-mcp", "generate_openapi_spec", {
61
+ "service": "users",
62
+ "version": "v1",
63
+ "format": "yaml", # "format" is a Python builtin
64
+ })
65
+ ```
66
+
67
+ ### List Servers & Tools
68
+
69
+ ```python
70
+ # All servers
71
+ servers = client.servers()
72
+ for s in servers:
73
+ print(f"{s['name']} — {s['toolCount']} tools")
74
+
75
+ # All tools (or filter)
76
+ tools = client.tools(server="database-mcp")
77
+ tools = client.tools(search="schema")
78
+ ```
79
+
80
+ ### Batch Execution
81
+
82
+ Execute up to 10 tools in parallel:
83
+
84
+ ```python
85
+ result = client.batch([
86
+ {"server": "database-mcp", "tool": "design_schema",
87
+ "args": {"aggregate": "Order", "database": "postgresql"}},
88
+ {"server": "devops-mcp", "tool": "generate_dockerfile",
89
+ "args": {"runtime": "node", "version": "20"}},
90
+ {"server": "devops-mcp", "tool": "generate_k8s_deployment",
91
+ "args": {"name": "order-service"}},
92
+ ])
93
+
94
+ print(f"{result.succeeded}/{len(result.results)} succeeded")
95
+ for r in result.results:
96
+ print(r.text[:100])
97
+ ```
98
+
99
+ ### Workflows
100
+
101
+ Run multi-step pipelines that chain tools together:
102
+
103
+ ```python
104
+ # List available workflows
105
+ workflows = client.workflows()
106
+ for wf in workflows:
107
+ print(f"{wf['id']} — {wf['stepCount']} steps")
108
+
109
+ # Run a workflow
110
+ result = client.run_workflow("microservice-scaffold",
111
+ name="orders",
112
+ language="node",
113
+ database="postgresql")
114
+
115
+ print(result) # Step-by-step summary
116
+ print(result.success)
117
+ print(result.total_duration_ms)
118
+
119
+ for step in result.results:
120
+ print(f"{step['tool']} — {step['durationMs']}ms")
121
+ ```
122
+
123
+ **Available workflows:**
124
+ - `microservice-scaffold` — Microservice + schema + migration + Docker + K8s (5 steps)
125
+ - `api-full-stack` — OpenAPI + endpoint + tests + contracts (4 steps)
126
+ - `ddd-complete` — Bounded context + model + aggregate + entity + repo + schema (6 steps)
127
+ - `event-driven` — Kafka + event handler + DLQ (3 steps)
128
+ - `deploy-stack` — Dockerfile + Compose + K8s + Helm (4 steps)
129
+ - `database-setup` — Schema + ORM + migration + seed (4 steps)
130
+
131
+ ## 9 Servers, 325 Tools
132
+
133
+ | Server | Tools | Coverage |
134
+ |--------|-------|----------|
135
+ | AWS | 53 | EC2, S3, Lambda, RDS, ECS, CloudFormation, IAM |
136
+ | GCP | 41 | Compute, GKE, Cloud Run, BigQuery, Pub/Sub |
137
+ | Full Stack | 38 | Express, NestJS, React, Vue, Next.js, FastAPI |
138
+ | Frontend | 36 | Components, state, routing, forms, accessibility |
139
+ | Database | 34 | PostgreSQL, MySQL, MongoDB, Prisma, migrations |
140
+ | Testing | 31 | Jest, Vitest, Cypress, load tests, mocks |
141
+ | Security | 31 | Auth, RBAC, encryption, OWASP, scanning |
142
+ | DevOps | 31 | Docker, K8s, Terraform, Helm, CI/CD, Prometheus |
143
+ | API | 30 | OpenAPI, GraphQL, gRPC, Kafka, webhooks, OAuth |
144
+
145
+ ## Error Handling
146
+
147
+ ```python
148
+ from crowvault import CrowVaultClient
149
+ from crowvault.client import CrowVaultError
150
+
151
+ client = CrowVaultClient()
152
+
153
+ try:
154
+ result = client.call("database-mcp", "design_schema",
155
+ aggregate="Order", database="postgresql")
156
+ print(result.text)
157
+ except CrowVaultError as e:
158
+ print(f"Error: {e} (HTTP {e.status})")
159
+ ```
160
+
161
+ ## Pricing
162
+
163
+ - **Free**: 50 calls/month, 2 API keys — [Sign up free](https://crowvault.ai/register?plan=free)
164
+ - **Developer**: $49/month, 1,000 calls, 5 keys
165
+ - **Team**: $199/month, 10,000 calls, 10 keys
166
+ - **Enterprise**: Custom
167
+
168
+ ## License
169
+
170
+ MIT. Copyright TechSynergy Corp.
@@ -0,0 +1,9 @@
1
+ # Copyright (c) 2026 TechSynergy Corp. All rights reserved.
2
+ # https://crowvault.ai
3
+
4
+ """CrowVault Python SDK — 325 AI-powered dev tools via one API."""
5
+
6
+ from crowvault.client import CrowVaultClient
7
+
8
+ __version__ = "2.0.0"
9
+ __all__ = ["CrowVaultClient"]
@@ -0,0 +1,212 @@
1
+ # Copyright (c) 2026 TechSynergy Corp. All rights reserved.
2
+ # https://crowvault.ai
3
+
4
+ """CrowVault API client — zero external dependencies (uses urllib)."""
5
+
6
+ import json
7
+ import os
8
+ import urllib.request
9
+ import urllib.error
10
+ from typing import Any
11
+
12
+
13
+ class CrowVaultError(Exception):
14
+ """Raised when the CrowVault API returns an error."""
15
+
16
+ def __init__(self, message: str, status: int = 0, meta: dict | None = None):
17
+ super().__init__(message)
18
+ self.status = status
19
+ self.meta = meta or {}
20
+
21
+
22
+ class CrowVaultClient:
23
+ """Client for the CrowVault API.
24
+
25
+ Usage:
26
+ from crowvault import CrowVaultClient
27
+
28
+ client = CrowVaultClient(api_key="cv_...")
29
+ result = client.call("database-mcp", "design_schema", aggregate="Order", database="postgresql")
30
+ print(result.text)
31
+ """
32
+
33
+ DEFAULT_URL = "https://api.crowvault.ai"
34
+ TIMEOUT = 60
35
+
36
+ def __init__(
37
+ self,
38
+ api_key: str | None = None,
39
+ api_url: str | None = None,
40
+ timeout: int | None = None,
41
+ ):
42
+ self.api_key = api_key or os.environ.get("CROWVAULT_API_KEY", "")
43
+ self.api_url = (api_url or os.environ.get("CROWVAULT_API_URL", self.DEFAULT_URL)).rstrip("/")
44
+ self.timeout = timeout or self.TIMEOUT
45
+
46
+ if not self.api_key:
47
+ raise CrowVaultError("API key required. Pass api_key or set CROWVAULT_API_KEY env var.")
48
+
49
+ def _request(self, method: str, path: str, body: dict | None = None) -> dict:
50
+ url = f"{self.api_url}{path}"
51
+ headers = {
52
+ "Authorization": f"Bearer {self.api_key}",
53
+ "Content-Type": "application/json",
54
+ "User-Agent": "crowvault-python/2.0.0",
55
+ }
56
+ data = json.dumps(body).encode() if body else None
57
+ req = urllib.request.Request(url, data=data, headers=headers, method=method)
58
+
59
+ try:
60
+ with urllib.request.urlopen(req, timeout=self.timeout) as resp:
61
+ return json.loads(resp.read().decode())
62
+ except urllib.error.HTTPError as e:
63
+ try:
64
+ err_body = json.loads(e.read().decode())
65
+ msg = err_body.get("error", f"HTTP {e.code}")
66
+ except Exception:
67
+ msg = f"HTTP {e.code}"
68
+ raise CrowVaultError(msg, status=e.code) from None
69
+ except urllib.error.URLError as e:
70
+ raise CrowVaultError(f"Connection error: {e.reason}") from None
71
+
72
+ # ── Servers & Tools ──────────────────────────────────────────────────
73
+
74
+ def servers(self) -> list[dict]:
75
+ """List all MCP servers with tool counts."""
76
+ data = self._request("GET", "/v1/servers")
77
+ return data.get("servers", [])
78
+
79
+ def tools(self, server: str | None = None, search: str | None = None) -> list[dict]:
80
+ """List tools, optionally filtered by server or search query."""
81
+ params = []
82
+ if server:
83
+ params.append(f"server={server}")
84
+ if search:
85
+ params.append(f"search={urllib.request.quote(search)}")
86
+ qs = f"?{'&'.join(params)}" if params else ""
87
+ data = self._request("GET", f"/v1/tools{qs}")
88
+ return data.get("tools", [])
89
+
90
+ # ── Tool Execution ───────────────────────────────────────────────────
91
+
92
+ def call(self, server: str, tool: str, **args: Any) -> "ToolResult":
93
+ """Call a single tool.
94
+
95
+ Args:
96
+ server: Server ID (e.g., "database-mcp")
97
+ tool: Tool name (e.g., "design_schema")
98
+ **args: Tool arguments as keyword args
99
+
100
+ Returns:
101
+ ToolResult with .text, .success, .meta
102
+
103
+ Example:
104
+ result = client.call("database-mcp", "design_schema",
105
+ aggregate="Order", database="postgresql")
106
+ """
107
+ data = self._request("POST", "/v1/tools/call", {
108
+ "server": server, "tool": tool, "args": args,
109
+ })
110
+ return ToolResult(data)
111
+
112
+ def call_raw(self, server: str, tool: str, args: dict | None = None) -> "ToolResult":
113
+ """Call a single tool with a dict of args (instead of kwargs).
114
+
115
+ Useful when arg names conflict with Python keywords.
116
+ """
117
+ data = self._request("POST", "/v1/tools/call", {
118
+ "server": server, "tool": tool, "args": args or {},
119
+ })
120
+ return ToolResult(data)
121
+
122
+ def batch(self, requests: list[dict]) -> "BatchResult":
123
+ """Execute multiple tools in parallel (max 10).
124
+
125
+ Args:
126
+ requests: List of {"server": str, "tool": str, "args": dict}
127
+
128
+ Returns:
129
+ BatchResult with .results, .succeeded, .failed
130
+ """
131
+ if len(requests) > 10:
132
+ raise CrowVaultError("Maximum 10 requests per batch")
133
+ data = self._request("POST", "/v1/tools/batch", {"requests": requests})
134
+ return BatchResult(data)
135
+
136
+ # ── Workflows ────────────────────────────────────────────────────────
137
+
138
+ def workflows(self) -> list[dict]:
139
+ """List available workflows."""
140
+ data = self._request("GET", "/v1/workflows")
141
+ return data.get("workflows", [])
142
+
143
+ def run_workflow(self, workflow: str, **args: Any) -> "WorkflowResult":
144
+ """Execute a multi-step workflow.
145
+
146
+ Args:
147
+ workflow: Workflow ID (e.g., "microservice-scaffold")
148
+ **args: Input arguments as keyword args
149
+
150
+ Returns:
151
+ WorkflowResult with .success, .results, .total_duration_ms
152
+ """
153
+ data = self._request("POST", "/v1/workflows/execute", {
154
+ "workflow": workflow, "args": args,
155
+ })
156
+ return WorkflowResult(data)
157
+
158
+
159
+ class ToolResult:
160
+ """Result from a single tool call."""
161
+
162
+ def __init__(self, data: dict):
163
+ self._data = data
164
+ self.success = data.get("success", not data.get("error"))
165
+ self.text = data.get("result", data.get("text", ""))
166
+ self.error = data.get("error")
167
+ self.meta = data.get("meta", {})
168
+
169
+ def __str__(self) -> str:
170
+ return self.text if self.success else f"Error: {self.error}"
171
+
172
+ def __repr__(self) -> str:
173
+ return f"ToolResult(success={self.success}, length={len(self.text)})"
174
+
175
+
176
+ class BatchResult:
177
+ """Result from a batch execution."""
178
+
179
+ def __init__(self, data: dict):
180
+ self._data = data
181
+ self.results = [ToolResult(r) for r in data.get("results", [])]
182
+ self.meta = data.get("meta", {})
183
+ self.succeeded = self.meta.get("succeeded", 0)
184
+ self.failed = self.meta.get("failed", 0)
185
+ self.total_duration_ms = self.meta.get("totalDurationMs", 0)
186
+
187
+ def __repr__(self) -> str:
188
+ return f"BatchResult(succeeded={self.succeeded}, failed={self.failed})"
189
+
190
+
191
+ class WorkflowResult:
192
+ """Result from a workflow execution."""
193
+
194
+ def __init__(self, data: dict):
195
+ self._data = data
196
+ self.success = data.get("success", False)
197
+ self.workflow = data.get("workflow", "")
198
+ self.failed_step = data.get("failedStep")
199
+ self.total_duration_ms = data.get("totalDurationMs", 0)
200
+ self.results = data.get("results", [])
201
+
202
+ def __repr__(self) -> str:
203
+ steps = len(self.results)
204
+ return f"WorkflowResult(success={self.success}, steps={steps}, duration={self.total_duration_ms}ms)"
205
+
206
+ def __str__(self) -> str:
207
+ lines = []
208
+ for i, r in enumerate(self.results):
209
+ icon = "+" if r.get("success") else "x"
210
+ lines.append(f" [{icon}] {i+1}. {r.get('tool', '?')} — {r.get('durationMs', 0)}ms")
211
+ status = "OK" if self.success else f"FAILED at {self.failed_step}"
212
+ return f"Workflow: {self.workflow} ({status}, {self.total_duration_ms}ms)\n" + "\n".join(lines)
@@ -0,0 +1,195 @@
1
+ Metadata-Version: 2.4
2
+ Name: crowvault
3
+ Version: 2.0.0
4
+ Summary: CrowVault Python SDK — 325 AI-powered dev tools via one API. Zero dependencies.
5
+ Author-email: "TechSynergy Corp." <hello@crowvault.ai>
6
+ License: MIT
7
+ Project-URL: Homepage, https://crowvault.ai
8
+ Project-URL: Documentation, https://crowvault.ai/docs
9
+ Project-URL: Pricing, https://crowvault.ai/pricing
10
+ Project-URL: Contact, https://crowvault.ai/contact
11
+ Keywords: crowvault,mcp,ai,dev-tools,code-generation,schema,terraform,openapi,kubernetes,dockerfile,ddd,workflow,devops
12
+ Classifier: Development Status :: 5 - Production/Stable
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.9
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Software Development :: Code Generators
22
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
+ Requires-Python: >=3.9
24
+ Description-Content-Type: text/markdown
25
+
26
+ # crowvault
27
+
28
+ Python SDK for [CrowVault](https://crowvault.ai) — 325 AI-powered dev tools via one API. Zero dependencies.
29
+
30
+ ## Install
31
+
32
+ ```bash
33
+ pip install crowvault
34
+ ```
35
+
36
+ ## Quick Start
37
+
38
+ ```python
39
+ from crowvault import CrowVaultClient
40
+
41
+ client = CrowVaultClient(api_key="cv_your_key_here")
42
+
43
+ # Generate a database schema
44
+ result = client.call("database-mcp", "design_schema",
45
+ aggregate="Order", database="postgresql")
46
+ print(result.text)
47
+
48
+ # Generate a Dockerfile
49
+ result = client.call("devops-mcp", "generate_dockerfile",
50
+ runtime="node", version="20")
51
+ print(result.text)
52
+ ```
53
+
54
+ ## Authentication
55
+
56
+ ```python
57
+ # Option 1: Pass directly
58
+ client = CrowVaultClient(api_key="cv_...")
59
+
60
+ # Option 2: Environment variable
61
+ # export CROWVAULT_API_KEY=cv_...
62
+ client = CrowVaultClient()
63
+ ```
64
+
65
+ ## API Reference
66
+
67
+ ### Call a Tool
68
+
69
+ ```python
70
+ result = client.call("database-mcp", "design_schema",
71
+ aggregate="Order",
72
+ database="postgresql",
73
+ outputFormat="prisma")
74
+
75
+ print(result.text) # Generated code
76
+ print(result.success) # True/False
77
+ print(result.meta) # {server, tool, durationMs, ...}
78
+ ```
79
+
80
+ ### Call with Dict Args
81
+
82
+ Use `call_raw()` when arg names conflict with Python keywords:
83
+
84
+ ```python
85
+ result = client.call_raw("api-mcp", "generate_openapi_spec", {
86
+ "service": "users",
87
+ "version": "v1",
88
+ "format": "yaml", # "format" is a Python builtin
89
+ })
90
+ ```
91
+
92
+ ### List Servers & Tools
93
+
94
+ ```python
95
+ # All servers
96
+ servers = client.servers()
97
+ for s in servers:
98
+ print(f"{s['name']} — {s['toolCount']} tools")
99
+
100
+ # All tools (or filter)
101
+ tools = client.tools(server="database-mcp")
102
+ tools = client.tools(search="schema")
103
+ ```
104
+
105
+ ### Batch Execution
106
+
107
+ Execute up to 10 tools in parallel:
108
+
109
+ ```python
110
+ result = client.batch([
111
+ {"server": "database-mcp", "tool": "design_schema",
112
+ "args": {"aggregate": "Order", "database": "postgresql"}},
113
+ {"server": "devops-mcp", "tool": "generate_dockerfile",
114
+ "args": {"runtime": "node", "version": "20"}},
115
+ {"server": "devops-mcp", "tool": "generate_k8s_deployment",
116
+ "args": {"name": "order-service"}},
117
+ ])
118
+
119
+ print(f"{result.succeeded}/{len(result.results)} succeeded")
120
+ for r in result.results:
121
+ print(r.text[:100])
122
+ ```
123
+
124
+ ### Workflows
125
+
126
+ Run multi-step pipelines that chain tools together:
127
+
128
+ ```python
129
+ # List available workflows
130
+ workflows = client.workflows()
131
+ for wf in workflows:
132
+ print(f"{wf['id']} — {wf['stepCount']} steps")
133
+
134
+ # Run a workflow
135
+ result = client.run_workflow("microservice-scaffold",
136
+ name="orders",
137
+ language="node",
138
+ database="postgresql")
139
+
140
+ print(result) # Step-by-step summary
141
+ print(result.success)
142
+ print(result.total_duration_ms)
143
+
144
+ for step in result.results:
145
+ print(f"{step['tool']} — {step['durationMs']}ms")
146
+ ```
147
+
148
+ **Available workflows:**
149
+ - `microservice-scaffold` — Microservice + schema + migration + Docker + K8s (5 steps)
150
+ - `api-full-stack` — OpenAPI + endpoint + tests + contracts (4 steps)
151
+ - `ddd-complete` — Bounded context + model + aggregate + entity + repo + schema (6 steps)
152
+ - `event-driven` — Kafka + event handler + DLQ (3 steps)
153
+ - `deploy-stack` — Dockerfile + Compose + K8s + Helm (4 steps)
154
+ - `database-setup` — Schema + ORM + migration + seed (4 steps)
155
+
156
+ ## 9 Servers, 325 Tools
157
+
158
+ | Server | Tools | Coverage |
159
+ |--------|-------|----------|
160
+ | AWS | 53 | EC2, S3, Lambda, RDS, ECS, CloudFormation, IAM |
161
+ | GCP | 41 | Compute, GKE, Cloud Run, BigQuery, Pub/Sub |
162
+ | Full Stack | 38 | Express, NestJS, React, Vue, Next.js, FastAPI |
163
+ | Frontend | 36 | Components, state, routing, forms, accessibility |
164
+ | Database | 34 | PostgreSQL, MySQL, MongoDB, Prisma, migrations |
165
+ | Testing | 31 | Jest, Vitest, Cypress, load tests, mocks |
166
+ | Security | 31 | Auth, RBAC, encryption, OWASP, scanning |
167
+ | DevOps | 31 | Docker, K8s, Terraform, Helm, CI/CD, Prometheus |
168
+ | API | 30 | OpenAPI, GraphQL, gRPC, Kafka, webhooks, OAuth |
169
+
170
+ ## Error Handling
171
+
172
+ ```python
173
+ from crowvault import CrowVaultClient
174
+ from crowvault.client import CrowVaultError
175
+
176
+ client = CrowVaultClient()
177
+
178
+ try:
179
+ result = client.call("database-mcp", "design_schema",
180
+ aggregate="Order", database="postgresql")
181
+ print(result.text)
182
+ except CrowVaultError as e:
183
+ print(f"Error: {e} (HTTP {e.status})")
184
+ ```
185
+
186
+ ## Pricing
187
+
188
+ - **Free**: 50 calls/month, 2 API keys — [Sign up free](https://crowvault.ai/register?plan=free)
189
+ - **Developer**: $49/month, 1,000 calls, 5 keys
190
+ - **Team**: $199/month, 10,000 calls, 10 keys
191
+ - **Enterprise**: Custom
192
+
193
+ ## License
194
+
195
+ MIT. Copyright TechSynergy Corp.
@@ -0,0 +1,8 @@
1
+ README.md
2
+ pyproject.toml
3
+ crowvault/__init__.py
4
+ crowvault/client.py
5
+ crowvault.egg-info/PKG-INFO
6
+ crowvault.egg-info/SOURCES.txt
7
+ crowvault.egg-info/dependency_links.txt
8
+ crowvault.egg-info/top_level.txt
@@ -0,0 +1 @@
1
+ crowvault
@@ -0,0 +1,35 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "crowvault"
7
+ version = "2.0.0"
8
+ description = "CrowVault Python SDK — 325 AI-powered dev tools via one API. Zero dependencies."
9
+ readme = "README.md"
10
+ license = {text = "MIT"}
11
+ requires-python = ">=3.9"
12
+ authors = [{name = "TechSynergy Corp.", email = "hello@crowvault.ai"}]
13
+ keywords = ["crowvault", "mcp", "ai", "dev-tools", "code-generation", "schema", "terraform", "openapi", "kubernetes", "dockerfile", "ddd", "workflow", "devops"]
14
+ classifiers = [
15
+ "Development Status :: 5 - Production/Stable",
16
+ "Intended Audience :: Developers",
17
+ "License :: OSI Approved :: MIT License",
18
+ "Programming Language :: Python :: 3",
19
+ "Programming Language :: Python :: 3.9",
20
+ "Programming Language :: Python :: 3.10",
21
+ "Programming Language :: Python :: 3.11",
22
+ "Programming Language :: Python :: 3.12",
23
+ "Programming Language :: Python :: 3.13",
24
+ "Topic :: Software Development :: Code Generators",
25
+ "Topic :: Software Development :: Libraries :: Python Modules",
26
+ ]
27
+
28
+ [project.urls]
29
+ Homepage = "https://crowvault.ai"
30
+ Documentation = "https://crowvault.ai/docs"
31
+ Pricing = "https://crowvault.ai/pricing"
32
+ Contact = "https://crowvault.ai/contact"
33
+
34
+ [tool.setuptools.packages.find]
35
+ include = ["crowvault*"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+