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 jazzmineUsage 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.
Reference map
Browse the core API docs by subsystem, then open full pages from the sidebar as needed.
Core Systems
4 pagesBuilder
5 pagesFlows
3 pagesLLM
4 pagesMemory
7 pages+2 more pages in this section