kalibr 1.0.24__py3-none-any.whl → 1.0.26__py3-none-any.whl

kalibr/__init__.py

@@ -1 +1,5 @@
-__version__ = "1.0.24"
+from .kalibr_app import KalibrApp
+from .kalibr import Kalibr
+
+__all__ = ["Kalibr", "KalibrApp"]
+__version__ = "1.0.26"

kalibr-1.0.26.dist-info/METADATA

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: kalibr
+Version: 1.0.26
+Summary: Multi-Model MCP SDK — deploy to GPT, Claude, Gemini, Copilot from one codebase.
+Home-page: https://github.com/devonakelley/kalibr-sdk
+Author: Kalibr Team
+Author-email: team@kalibr.dev
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.110.1
+Requires-Dist: uvicorn>=0.25.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: pydantic>=2.6.4
+Requires-Dist: requests>=2.31.0
+Requires-Dist: aiofiles>=23.2.1
+Requires-Dist: jsonschema>=4.21.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Kalibr SDK v1.0.26
+### Multi-Model AI Integration Framework
+
+**Write once. Deploy anywhere. Connect to any AI model.**
+
+Kalibr turns your Python functions into APIs that automatically work with **GPT Actions**, **Claude MCP**, **Gemini Extensions**, and **Copilot Plugins** — all from one codebase.  
+It’s the unified SDK layer for building, packaging, and deploying AI-ready endpoints.
+
+---
+
+## 🧠 Core Purpose
+
+Kalibr is a **multi-model integration SDK** that converts simple Python functions into fully MCP-compatible APIs for every major AI model ecosystem.
+
+> One function → Four schemas → Deploy anywhere.
+
+---
+
+## ⚙️ What It Does
+
+### 1. Unified Schema Generation
+
+Kalibr automatically generates and serves schemas for:
+- `/openapi.json` → GPT Actions
+- `/mcp.json` → Claude MCP
+- `/schemas/gemini` → Gemini Extensions
+- `/schemas/copilot` → Copilot Plugins
+- `/models/supported` → List of supported integrations
+
+No manual YAML or JSON schema creation needed.
+
+---
+
+### 2. Environment-Aware Base URLs
+
+Kalibr auto-detects where it's running and sets the correct base URL automatically:
+
+| Environment | Example Base URL |
+|--------------|------------------|
+| Local | `http://localhost:8000` |
+| Fly.io | `https://<app>.fly.dev` |
+| Render | `https://<app>.onrender.com` |
+| Custom | Set via `KALIBR_BASE_URL` |
+
+---
+
+### 3. Deployment & Runtime Abstraction
+
+Kalibr provides a single CLI entrypoint for local and hosted runtime deployment:
+
+```bash
+kalibr serve my_app.py
+kalibr deploy my_app.py --runtime fly|render|local
+kalibr version
+```
+
+Each runtime automatically generates valid schema URLs and deployment bundles (`Dockerfile`, `fly.toml`, etc).
+
+---
+
+### 4. Two Development Modes
+
+#### Simple Mode (Function-Level)
+For lightweight APIs and test integrations.
+
+```python
+from kalibr import Kalibr
+
+app = Kalibr(title="Weather API")
+
+@app.action("get_weather", "Fetch weather data")
+def get_weather(city: str):
+    return {"city": city, "temp": 72, "condition": "sunny"}
+```
+
+#### Advanced Mode (Full App)
+
+```python
+from kalibr import KalibrApp
+from kalibr.types import FileUpload, Session
+
+app = KalibrApp(title="Document API")
+
+@app.file_handler("analyze_doc", [".pdf", ".docx"])
+async def analyze_doc(file: FileUpload):
+    return {"filename": file.filename, "result": "parsed"}
+
+@app.session_action("save_data")
+async def save_data(session: Session, data: dict):
+    session.set("data", data)
+    return {"saved": True}
+```
+
+Includes:
+- Async/await support  
+- File uploads  
+- Session persistence  
+- Streaming responses  
+- Workflow scaffolding  
+
+---
+
+### 5. Built-in Routes
+
+| Endpoint | Purpose |
+|-----------|----------|
+| `/health` | Health + version check |
+| `/docs` | Swagger UI |
+| `/models/supported` | Shows model compatibility |
+| `/openapi.json`, `/mcp.json`, etc. | Model schemas |
+
+---
+
+### 6. CLI Reference
+
+```
+kalibr serve my_app.py        # Run locally
+kalibr deploy my_app.py       # Deploy to Fly/Render
+kalibr examples               # Copy examples
+kalibr version                # Show SDK version
+```
+
+---
+
+### 7. Value Proposition
+
+For developers or MCP infrastructure projects (e.g. Emergent):
+
+- **Instant MCP onboarding** — one file → all model schemas  
+- **Zero config** — no schema or deployment setup required  
+- **Multi-runtime support** — local, Fly, Render, or custom hosts  
+- **Unified interface layer** — consistent schema output for all AI platforms  
+
+---
+
+### 8. Upcoming Additions
+
+- Observability + tracing hooks  
+- Usage metering and billing  
+- Schema diffing / auto-validation  
+- Multi-runtime load routing  
+
+---
+
+### License
+
+MIT License © 2025 Kalibr Team  
+GitHub: [https://github.com/devonakelley/kalibr-sdk](https://github.com/devonakelley/kalibr-sdk)
+
+---
+
+**Kalibr SDK** — the unified layer between AI models and the real world.  
+Write once. Deploy anywhere. Integrate everything.

{kalibr-1.0.24.dist-info → kalibr-1.0.26.dist-info}/RECORD

@@ -1,4 +1,4 @@
-kalibr/__init__.py,sha256=rnKYfyIc2hXBxsPKz6c7OchEPYsBq3xHKgj-1s8ShT8,23
+kalibr/__init__.py,sha256=ho27It_rTdaObXXm0C4BswKheCuwHPOoJ03Q4lY4k1g,119
 kalibr/__main__.py,sha256=nRQLefjyoy9c_-UKU1UZGcCRrypQWchJAbUlmNFPv2g,8353
 kalibr/deployment.py,sha256=GZ874FXQX1uIroTA-UM5A-pTVn2UY0NxXi39vmTowyI,1396
 kalibr/kalibr.py,sha256=yrgXVlTgadBbpnX_l7fAxxjxGp9oxcZhzGjaQPiIcpo,10469
@@ -8,12 +8,12 @@ kalibr/runtime_router.py,sha256=PTXMj5yt72cfzYtjWQ-mUF3t8eov9nuXXI0ScIVNMrU,4606
 kalibr/schema_generators.py,sha256=xxnY05KgHTJ7BPXMCIC-McJCCt8aIOF5s0ptCwDqs_Y,6716
 kalibr/types.py,sha256=bNmf_cOWXBmhaMVAPEp3_EdRCcdXY2pbOgOxZ1dZ0Mc,3476
 kalibr/validator.py,sha256=PezDmHG9dVINce91rdYQstJC41eZP21qEA3VDICE3C4,2333
-kalibr-1.0.24.data/data/examples/README.md,sha256=loo2nm6yfT-pqGb5uNg1VeEdOKflYzHISUHTuSltfY0,4875
-kalibr-1.0.24.data/data/examples/basic_kalibr_example.py,sha256=Kfrh-XZuJ0vwFLB_xBpdqpgpMJw2NpIx0yBsqrAqBnE,2188
-kalibr-1.0.24.data/data/examples/enhanced_kalibr_example.py,sha256=AuhTpyRUNVAJuZKRy9iydXusNkBgQ84eKNiXxsr4iUQ,11994
-kalibr-1.0.24.dist-info/licenses/LICENSE,sha256=1WLJDkrueNpHCROy9zANrK2Ar2weqZ_z88hw90UKDoc,451
-kalibr-1.0.24.dist-info/METADATA,sha256=aOYaifRrS0cdDX-ZxmzK6tbepqclKAx1qx2oP009cRM,5424
-kalibr-1.0.24.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kalibr-1.0.24.dist-info/entry_points.txt,sha256=KiJfV_BaeYdIdYniww3wnSBBqSHpRxP9BTLNwu7IjyY,48
-kalibr-1.0.24.dist-info/top_level.txt,sha256=OkloC5_IfpE4-QwI30aLIYbFZk_-ChABWF7aBGddy28,7
-kalibr-1.0.24.dist-info/RECORD,,
+kalibr-1.0.26.data/data/examples/README.md,sha256=loo2nm6yfT-pqGb5uNg1VeEdOKflYzHISUHTuSltfY0,4875
+kalibr-1.0.26.data/data/examples/basic_kalibr_example.py,sha256=Kfrh-XZuJ0vwFLB_xBpdqpgpMJw2NpIx0yBsqrAqBnE,2188
+kalibr-1.0.26.data/data/examples/enhanced_kalibr_example.py,sha256=AuhTpyRUNVAJuZKRy9iydXusNkBgQ84eKNiXxsr4iUQ,11994
+kalibr-1.0.26.dist-info/licenses/LICENSE,sha256=1WLJDkrueNpHCROy9zANrK2Ar2weqZ_z88hw90UKDoc,451
+kalibr-1.0.26.dist-info/METADATA,sha256=c7Q1uF9Dgwb15g_7xTJ_WfHpCy6u1JcQtFBj_Nz472k,4556
+kalibr-1.0.26.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kalibr-1.0.26.dist-info/entry_points.txt,sha256=KiJfV_BaeYdIdYniww3wnSBBqSHpRxP9BTLNwu7IjyY,48
+kalibr-1.0.26.dist-info/top_level.txt,sha256=OkloC5_IfpE4-QwI30aLIYbFZk_-ChABWF7aBGddy28,7
+kalibr-1.0.26.dist-info/RECORD,,

kalibr-1.0.24.dist-info/METADATA

@@ -1,231 +0,0 @@
-Metadata-Version: 2.4
-Name: kalibr
-Version: 1.0.24
-Summary: Multi-Model MCP SDK — deploy to GPT, Claude, Gemini, Copilot from one codebase.
-Home-page: https://github.com/devonakelley/kalibr-sdk
-Author: Kalibr Team
-Author-email: team@kalibr.dev
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: fastapi>=0.110.1
-Requires-Dist: uvicorn>=0.25.0
-Requires-Dist: typer>=0.9.0
-Requires-Dist: pydantic>=2.6.4
-Requires-Dist: requests>=2.31.0
-Requires-Dist: aiofiles>=23.2.1
-Requires-Dist: jsonschema>=4.21.1
-Dynamic: author
-Dynamic: author-email
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-
-# Kalibr SDK  
-### Multi-Model AI Integration Framework
-
-**Write once. Deploy anywhere. Connect to any AI model.**
-
-Kalibr turns Python functions into APIs that work seamlessly with GPT, Claude, Gemini, and Copilot — automatically generating model-specific schemas and endpoints.
-
----
-
-## 🚀 Quick Start (2 minutes)
-
-### 1. Install
-```bash
-pip install kalibr
-```
-
-### 2. Get Examples
-```bash
-kalibr-connect examples
-```
-This copies example files to `./kalibr_examples/` in your current directory.
-
-### 3. Run Demo
-```bash
-kalibr-connect serve kalibr_examples/basic_kalibr_example.py
-```
-
-### 4. See All Schemas
-Kalibr now **auto-detects your environment** and generates the correct base URLs.
-
-| Environment | Example Base URL |
-|--------------|------------------|
-| Local Dev | `http://localhost:8000` |
-| Fly.io | `https://<app-name>.fly.dev` |
-| Custom Host | Use `KALIBR_BASE_URL` env var |
-
-Then open:
-```
-<your-base-url>/gpt-actions.json    # ChatGPT
-<your-base-url>/mcp.json            # Claude
-<your-base-url>/schemas/gemini      # Gemini
-<your-base-url>/schemas/copilot     # Copilot
-```
-
----
-
-## 🧠 What Kalibr Does
-
-Kalibr turns your Python functions into production-ready multi-model APIs.
-
-```python
-from kalibr import Kalibr
-
-app = Kalibr(title="Inventory API")
-
-@app.action("get_inventory", "Fetch inventory data")
-def get_inventory(product_id: str):
-    return {"product_id": product_id, "stock": 42}
-```
-
-Result:  
-ChatGPT, Claude, Gemini, and Copilot can all call `get_inventory()` using their native protocols — no schema work required.
-
----
-
-## 💪 Two Modes
-
-### **Function-Level (Simple)**
-Ideal for one-off APIs or scripts.
-
-```python
-from kalibr import Kalibr
-
-app = Kalibr(title="My API")
-
-@app.action("calculate_price", "Calculate price total")
-def calculate_price(product_id: str, quantity: int):
-    return {"total": quantity * 19.99}
-```
-
-### **App-Level (Advanced)**
-Use `KalibrApp` for complete control — file uploads, sessions, streaming, and workflows.
-
-```python
-from kalibr import KalibrApp
-from kalibr.types import FileUpload, Session
-
-app = KalibrApp(title="Advanced API")
-
-@app.file_handler("analyze_doc", [".pdf", ".docx"])
-async def analyze_doc(file: FileUpload):
-    return {"filename": file.filename, "analysis": "..."}
-
-@app.session_action("save_data", "Save session data")
-async def save_data(session: Session, data: dict):
-    session.set("my_data", data)
-    return {"saved": True}
-```
-
----
-
-## 📚 Examples Included
-
-After running `kalibr-connect examples`, you’ll get:
-
-- `basic_kalibr_example.py` – simple function-level demo  
-- `enhanced_kalibr_example.py` – full app with sessions, uploads, and streaming  
-
----
-
-## 🤖 AI Platform Integration
-
-### ChatGPT (GPT Actions)
-1. Copy schema URL:  
-   `https://<your-domain>/gpt-actions.json`
-2. In GPT Builder → *Actions* → *Import from URL*
-3. Done — ChatGPT can call your endpoints.
-
-### Claude (MCP)
-Add to Claude Desktop config:
-```json
-{
-  "mcp": {
-    "servers": {
-      "my-api": {
-        "url": "https://<your-domain>/mcp.json"
-      }
-    }
-  }
-}
-```
-
-### Gemini / Copilot
-Use:
-```
-https://<your-domain>/schemas/gemini
-https://<your-domain>/schemas/copilot
-```
-
----
-
-## 🎯 Common Use Cases
-
-- **Customer Service APIs** — let AI handle orders or refunds  
-- **Data Analysis** — query your analytics through AI  
-- **Document Processing** — parse or summarize uploaded docs  
-- **Business Automation** — trigger internal workflows  
-- **Internal Tools** — expose secure internal logic to assistants  
-
----
-
-## 🔧 CLI Reference
-
-```bash
-kalibr-connect examples          # Copy examples
-kalibr-connect serve my_app.py   # Run locally
-kalibr-connect version           # Show version
-kalibr-connect --help            # Full CLI
-```
-
----
-
-## ⚡ Key Features
-
-✅ Multi-Model Support — GPT, Claude, Gemini, Copilot  
-✅ Automatic Schema Generation  
-✅ Environment-Aware Base URLs (v1.0.21+)  
-✅ File Uploads  
-✅ Session Management  
-✅ Streaming Responses  
-✅ Workflow Support  
-✅ Type-Safe API Generation  
-✅ Async / Await Ready  
-
----
-
-## 🔥 Why Kalibr?
-
-Without Kalibr:
-- Learn 4 model specs  
-- Maintain 4 codebases  
-- Duplicate effort  
-
-With Kalibr:
-- One Python function  
-- Four schemas generated automatically  
-- Deploy anywhere  
-
----
-
-## 🆕 Version 1.0.21+
-
-- **Automatic Base-URL Detection**  
-  - Works with `KALIBR_BASE_URL` or `FLY_APP_NAME`  
-  - Fixes all localhost references in deployed schemas  
-- Ready for **MCP ecosystem production use**  
-- Drop-in backwards compatibility  
-
----
-
-## 🧩 License
-
-MIT License — see `LICENSE` file for details.  
-
----
-
-**Kalibr SDK — the unified layer between AI models and the real world.**  
-Write once. Deploy anywhere. Integrate everything.