🌙 Cocapn Oneiros

Dream-state agent orchestration — sleep cycles, background processing, dream journal

Agents dream while idle. Oneiros manages sleep/wake cycles, runs background tasks during downtime, and keeps a dream journal of what happened.

Install

pip install cocapn-oneiros

Quick Start

Dream Cycle

from cocapn_oneiros import DreamCycle

dream = DreamCycle(agent_id="oracle1")
dream.register_dream_task("consolidate_memory", lambda: "consolidated 42 tiles")
dream.mark_idle()

result = dream.dream()
print(f"Success: {result.success}, Result: {result.result}")
print(f"Journal: {dream.journal.stats()}")

Sleep Scheduler

from cocapn_oneiros import SleepScheduler

scheduler = SleepScheduler()
scheduler.register("oracle1", timezone_offset=-8)
print(f"Current phase: {scheduler.current_phase('oracle1')}")

Part of Cocapn · Agent Infrastructure