This directory contains practical examples demonstrating SochDB Python SDK usage across various scenarios.

# Install the SDK
cd sochdb-python-sdk
pip install -e .

# Build the native library (for embedded mode)
cd ..
cargo build --release

# Set the library path
export SOCHDB_LIB_PATH=/path/to/toon_database/target/release

# Run any example
python examples/01_basic_operations.py

Requires a running SochDB IPC server:

# Start the server first (from sochdb-storage)
cargo run --bin ipc_server -- --socket /tmp/sochdb.sock

# Then run the example
python examples/08_ipc_client.py

Runs a minimal hosted gRPC check without requiring Studio event ingestion:

SOCHDB_GRPC_ADDRESS=studio.agentslab.host:50053 \
python examples/27_hosted_remote_smoke.py

There is also a matching manual GitHub Actions workflow at .github/workflows/hosted-smoke.yml for running the same hosted smoke path on demand.

Latest hosted validation:

• GitHub-hosted workflow passed on May 5, 2026: https://github.com/SaiSandeepKantareddy/sochdb-python-sdk/actions/runs/25357489415

Runs a CrewAI agent with SochDB-backed search and remember tools:

pip install -e ".[crewai]"
OPENAI_API_KEY=... python examples/28_crewai_knowledge_tools.py

Runs the same CrewAI tool surface against a hosted SochDB collection over gRPC:

pip install -e ".[crewai]"
OPENAI_API_KEY=... \
SOCHDB_GRPC_ADDRESS=studio.agentslab.host:50053 \
python examples/29_crewai_remote_tools.py

If you want to validate just the remote SochDB side before wiring an LLM provider, you can run a storage/search smoke instead:

SOCHDB_GRPC_ADDRESS=studio.agentslab.host:50053 \
SOCHDB_CREWAI_SKIP_KICKOFF=1 \
python examples/29_crewai_remote_tools.py

examples/
├── README.md           # This file
├── 01_basic_operations.py      # Simple key-value CRUD
├── 02_transactions.py          # ACID transaction examples
├── 03_path_navigation.py       # Path-native API examples
├── 04_scan_and_range.py        # Range queries
├── 05_user_store.py            # User management use case
├── 06_json_documents.py        # JSON document storage
├── 07_session_cache.py         # Session caching pattern
├── 08_ipc_client.py            # IPC client examples
├── 26_hosted_studio_ingest.py  # Remote SochDB + hosted Studio example
├── 27_hosted_remote_smoke.py   # Minimal hosted gRPC smoke test
├── 28_crewai_knowledge_tools.py # CrewAI tools backed by SochDB knowledge
├── 29_crewai_remote_tools.py   # CrewAI tools backed by remote SochDB
└── shared/
    └── mock_server.py          # Mock server for testing

The simplest example to get started:

from sochdb import Database

# Open/create a database
db = Database.open("./my_data")

# Store data
db.put(b"greeting", b"Hello, SochDB!")

# Retrieve data
value = db.get(b"greeting")
print(value)  # b"Hello, SochDB!"

# Clean up
db.close()

• Key-Value Cache: Examples 1, 7
• User/Entity Management: Example 5
• Document Storage: Example 6
• Multi-process Access: Example 8
• Batch Operations: Example 4
• Hierarchical Data: Example 3