Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-omnicoreagent.omnirexfloralabs.com/llms.txt

Use this file to discover all available pages before exploring further.

Real Application Harness Examples

These examples show OmniCoreAgent as an application-facing agent harness, not a toy loop. Each app combines domain behavior with the built-in runtime pieces it needs: local tools, workspace files, tool offloading, guardrails, telemetry identifiers, and file commands.

Examples

ExampleRun commandWhat it demonstrates
Research due diligenceuv run python cookbook/real_applications/research_due_diligence_agent.pyParallel research tools, context management, large evidence offload, artifact readback, workspace report output, telemetry identifiers
Support operationsuv run python cookbook/real_applications/support_operations_agent.pyCustomer/order tools, support knowledge retrieval, guardrails, workspace ticket notes, telemetry
Personal operations assistantuv run python cookbook/real_applications/personal_operations_assistant.pyCalendar/task/preferences tools, selectable memory backend, private workspace brief, guardrails, telemetry identifiers
Workspace code reviewuv run python cookbook/real_applications/workspace_code_review_agent.pyBuilt-in workspace command tools for file discovery, grep-style search, reading, editing, and writing review output
Support background taskuv run python cookbook/background_agents/real_application_background_task.pyThe support operations app shape running through durable task state, attempts, lifecycle events, and workspace output

Run an Example

export LLM_API_KEY=your_key
uv run python cookbook/real_applications/research_due_diligence_agent.py
Expected output includes the agent response plus runtime identifiers such as trace_id and run_id. Workspace examples also print or create files under the configured workspace. The examples default to the provider/model from cookbook/shared.py. Override them with:
export OMNICOREAGENT_PROVIDER=openai
export OMNICOREAGENT_MODEL=gpt-5.4-mini
The personal assistant example defaults to in-memory history. To prove durable local memory without any external service, run it with SQLite:
export OMNICOREAGENT_COOKBOOK_MEMORY_BACKEND=sql
uv run python cookbook/real_applications/personal_operations_assistant.py

Why these examples exist

Application builders need to see where OmniCoreAgent owns the base harness and where their application code plugs in.
  • App code provides domain tools, instructions, data sources, and business rules.
  • OmniCoreAgent provides the model loop, tool execution, workspace files, structured observations, offloading, telemetry, memory, and guardrails.
  • The same application pattern can be served through OmniServe with cookbook/omniserve/real_application_agent.py.
  • The same application pattern can run as a background task with cookbook/background_agents/real_application_background_task.py.
Use these examples as starting points for your own application harness.