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

Example	Run command	What it demonstrates
Research due diligence	`uv run python cookbook/real_applications/research_due_diligence_agent.py`	Parallel research tools, context management, large evidence offload, artifact readback, workspace report output, telemetry identifiers
Support operations	`uv run python cookbook/real_applications/support_operations_agent.py`	Customer/order tools, support knowledge retrieval, guardrails, workspace ticket notes, telemetry
Personal operations assistant	`uv run python cookbook/real_applications/personal_operations_assistant.py`	Calendar/task/preferences tools, selectable memory backend, private workspace brief, guardrails, telemetry identifiers
Workspace code review	`uv run python cookbook/real_applications/workspace_code_review_agent.py`	Built-in workspace command tools for file discovery, grep-style search, reading, editing, and writing review output
Support background task	`uv run python cookbook/background_agents/real_application_background_task.py`	The 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.