jazzmine (Python Core)
Python backend engine for session orchestration, routing, and AI integration in the Jazzmine stack.
The jazzmine package is the Python backend engine for session orchestration, flow routing, tool
execution, and AI model integration.
Resilient imports
Core examples use a fallback import path so snippets keep working whether symbols are exported
from jazzmine.core or jazzmine.core.builder in your installed version.
Install
pip install jazzmineUsage quickstart
Build an agent, execute one chat turn, and always tear down resources.
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.
Reference
Browse the core API reference by subsystem in the sidebar — Agent, Builder, Flows, LLM, Memory, Message Store, Tools, and Core Systems.