v0.1.0
Python

jazzmine

Python backend engine for session orchestration, routing, and AI integration in the Jazzmine stack.

Overview

Resilient imports

Core examples use a fallback import path so snippets continue to work if symbols are exported from either `jazzmine.core` or `jazzmine.core.builder` in your installed version.

Install

install.sh
pip install jazzmine

Usage quickstart

Start from the same runtime shape used in Plug-and-Play: build an agent, execute one chat turn, and always teardown resources.

core_usage.py
import asyncio
import os

try:
  from jazzmine.core import AgentBuilder, OpenAILLMConfig
except ImportError:
  from jazzmine.core.builder import AgentBuilder, OpenAILLMConfig


async def main() -> None:
  builder = (
    AgentBuilder(
      name="CoreQuickstart",
      agent_id="core-quickstart-v1",
      personality="Concise and reliable assistant.",
    )
    .llm(
      OpenAILLMConfig(
        model=os.environ.get("MISTRAL_MODEL", "mistral-medium-latest"),
        api_key=os.environ["MISTRAL_API_KEY"],
        base_url=os.environ.get("MISTRAL_BASE_URL", "https://api.mistral.ai"),
      )
    )
  )

  agent, teardown = await builder.build()
  try:
    result = await agent.chat(
      user_id="demo-user",
      conversation_id="demo-conversation",
      content="Give me a short hello.",
    )
    print(result.response)
  finally:
    await teardown()


if __name__ == "__main__":
  asyncio.run(main())

Key features

  • Session-aware router for chat messages and tool execution workflows.
  • Middleware chain for logging, security checks, and request mutation.
  • Provider abstraction for plugging in AI models and retrieval pipelines.
  • Operational primitives for telemetry and graceful degradation behavior.

Quick navigation

Reference map

Browse the core API docs by subsystem, then open full pages from the sidebar as needed.