edgecrab-sdk

Python SDK for EdgeCrab — a Rust-native autonomous coding agent.

Install

pip install edgecrab-sdk

Quick Start

from edgecrab import EdgeCrabClient

# Connect to a running EdgeCrab API server
client = EdgeCrabClient(
    base_url="http://127.0.0.1:8642",
    api_key="your-api-key",  # optional
)

# Simple chat
reply = client.chat("Explain Rust ownership in 3 sentences")
print(reply)

# With system prompt
reply = client.chat(
    "Refactor this function",
    system="You are a senior Rust developer",
    model="anthropic/claude-sonnet-4-20250514",
)

Async

import asyncio
from edgecrab import AsyncEdgeCrabClient

async def main():
    async with AsyncEdgeCrabClient() as client:
        reply = await client.chat("Hello!")
        print(reply)

asyncio.run(main())

Agent API (recommended)

from edgecrab import Agent

agent = Agent(
    model="anthropic/claude-sonnet-4-20250514",
    system_prompt="You are a helpful coding assistant",
)

# Chat with automatic conversation history
reply = agent.chat("Explain Rust ownership")
print(reply)

# Continue the conversation
follow_up = agent.chat("Give me an example")
print(follow_up)

# Full run with result metadata
result = agent.run("Refactor this function")
print(result.response)
print(f"Turns: {result.turns_used}, Tokens: {result.usage.total_tokens}")

Streaming

from edgecrab import EdgeCrabClient, ChatMessage

with EdgeCrabClient() as client:
    messages = [ChatMessage(role="user", content="Write a haiku about Rust")]
    for chunk in client.stream_completion(messages=messages):
        for choice in chunk.choices:
            if choice.delta.content:
                print(choice.delta.content, end="", flush=True)
    print()

CLI

edgecrab chat "What is the meaning of life?"
edgecrab chat --model gpt-4 --system "Be concise" "Explain monads"
edgecrab chat --stream "Tell me a story"
edgecrab models
edgecrab health

Environment Variables

API Reference

EdgeCrabClient

AsyncEdgeCrabClient

Same API as EdgeCrabClient, but all methods are async.

Agent / AsyncAgent

Links

• GitHub
• Node.js SDK
• EdgeCrab Documentation