Spaces:
Paused
Paused
File size: 1,639 Bytes
4efde5d |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 |
# Kortix SDK
[](https://python.org)
A Python SDK that enables you to create, manage, and interact with AI Workers on [Suna](https://suna.so).
## 📦 Installation
Install directly from the GitHub repository:
```bash
pip install "kortix @ git+https://github.com/kortix-ai/suna.git@main#subdirectory=sdk"
```
Or using uv:
```bash
uv add "kortix @ git+https://github.com/kortix-ai/suna.git@main#subdirectory=sdk"
```
## 🔧 Quick Start
```python
import asyncio
from kortix import kortix
async def main():
mcp_tools = kortix.MCPTools(
"http://localhost:4000/mcp/", # Point to any HTTP MCP server
"Kortix",
)
await mcp_tools.initialize()
# Initialize the client
client = kortix.Kortix(api_key="your-api-key")
# Create an agent
agent = await client.Agent.create(
name="My Assistant",
system_prompt="You are a helpful AI assistant.",
mcp_tools=[mcp_tools],
allowed_tools=["get_wind_direction"],
)
# Create a conversation thread
thread = await client.Thread.create()
# Run the agent
run = await agent.run("Hello, how are you?", thread)
# Stream the response
stream = await run.get_stream()
async for chunk in stream:
print(chunk, end="")
if __name__ == "__main__":
asyncio.run(main())
```
## 🔑 Environment Setup
Get your API key from [https://suna.so/settings/api-keys](https://suna.so/settings/api-keys)
## 🧪 Running Examples
```bash
# Install dependencies
uv sync
# Run the main example
PYTHONPATH=$(pwd) uv run example/example.py
```
|