stitch-ai 0.2.7

Stitch AI SDK for managing memory spaces and memories

Stitch SDK

Stitch SDK is a Python library that wraps the API for managing memory spaces and memories. It provides both a Python SDK and a command-line interface (CLI).

Installation

pip install stitch_ai

CLI Usage

Before using the CLI, set your API key as an environment variable:

export STITCH_API_KEY=your_api_key

Available Commands

1. Create a new API key for a wallet:

stitch key <wallet_address>

2. Create a new memory space:

stitch create-space <space_name>

3. Push memory to a space:

stitch push <space_name> [-m COMMIT_MESSAGE] [-e EPISODIC_FILE_PATH] [-c CHARACTER_FILE_PATH]

4. Pull memory from a space:

stitch pull <space_name> <memory_id> [-p DB_PATH]

5. Pull external memory:

stitch pull-external <memory_id> [-p RAG_PATH]

6. List all memory spaces:

stitch list-spaces

7. List all memories in a space:

stitch list-memories <space_name>

Examples

# Create a new API key for a wallet
stitch key 0x1234567890abcdef1234567890abcdef12345678

# Create a new memory space
stitch create-space my_space

# Push memory with a message and files
stitch push my_space -m "Initial memory" -e ./agent/data/db.sqlite -c ./characters/default.character.json

# Pull a specific memory
stitch pull my_space memory_123 -p ./db/chroma.sqlite3

# Pull external memory
stitch pull-external memory_123 -p ./rag/rag.json

# List all memory spaces
stitch list-spaces

# List all memories in a space
stitch list-memories my_space

Environment Variables

• STITCH_API_KEY: Your API key (required)
• STITCH_API_URL: API endpoint (optional, defaults to https://api-devnet.stitch-ai.co)

SDK Usage

from stitch_ai import StitchSDK

sdk = StitchSDK()
sdk.create_space("my_space")