Python SDK Reference¶

Programmatic access to Nova Core orchestration.

Installation¶

pip install -r requirements.txt

Basic Usage¶

from pathlib import Path
from src.orchestrator.claude_sdk_executor import ClaudeSDKExecutor

# Initialize orchestrator
executor = ClaudeSDKExecutor(project_root=Path.cwd())

# Execute task
result = await executor.execute_task("implement REST API endpoint")

Plan/Execute Mode¶

from src.orchestrator.plan_execute_orchestrator import PlanExecuteOrchestrator

orchestrator = PlanExecuteOrchestrator(project_root=Path.cwd())

# Phase 1-4: Planning (read-only, Haiku - 97% cost savings)
plan = await orchestrator.plan("Add user authentication")

# Phase 5-6: Execution (read/write, Sonnet)
result = await orchestrator.execute(plan)

Background Execution¶

from src.orchestrator.background_sdk_executor import BackgroundSDKExecutor

executor = BackgroundSDKExecutor(project_root=Path.cwd())

# Spawn background task
task_id = await executor.spawn_background_task(
    task_description="fix all failing tests",
    agent_name="validator",
    notify_on_completion=True
)

# Monitor progress
status = await executor.get_task_status(task_id)

[Full API documentation coming soon]