Python SDK

pip install velixar

from velixar import Velixar

v = Velixar(api_key="vlx_your_key")

# Store
memory_id = v.store("Staging database is in us-west-2", tags=["infrastructure"])

# Search
results = v.search("staging database")
for mem in results.memories:
    print(mem.content)

# Knowledge graph
graph = v.graph_traverse("PostgreSQL", depth=2)
for node in graph.nodes:
    print(f"{node.label} ({node.entity_type})")

# Identity
profile = v.get_identity()

# CI/CD webhook
v.webhook("deployment", "Deployed v1.0.0", version="1.0.0")

from velixar import AsyncVelixar

async with AsyncVelixar(api_key="vlx_your_key") as v:
    memory_id = await v.store("async memory")
    results = await v.search("async")
    graph = await v.graph_traverse("PostgreSQL")

v = Velixar(
    api_key="vlx_your_key",          # Required (or set VELIXAR_API_KEY env var)
    base_url="https://...",           # Optional — custom endpoint
    workspace_id="my-project",        # Optional — workspace isolation
    max_retries=3,                    # Optional
    timeout=30.0,                     # Optional (seconds)
)

from velixar import Memory, SearchResult, MemoryTier, GraphEntity, GraphRelation, TraverseResult

from velixar import VelixarError, AuthenticationError, RateLimitError, NotFoundError

try:
    v.get("nonexistent-id")
except NotFoundError:
    print("Memory not found")
except RateLimitError as e:
    print(f"Rate limited, retry after {e.retry_after}s")
except VelixarError as e:
    print(f"API error: {e}")