acty-core

acty-core

acty-core is the low-level runtime package behind the Acty ecosystem. It provides the scheduler, lifecycle controller, event bus, cache primitives, and lightweight demo executors without the higher-level TUI API.

Install

pip install acty-core

For local development:

pip install -e .[dev]

Example

Run the headless group demo:

python examples/group_headless.py --groups 3

Run the scheduler-only demo:

python examples/scheduler_headless.py --groups 3

Write JSONL events that can be inspected later:

python examples/scheduler_jsonl.py --event-jsonl /tmp/acty_events.jsonl

What It Includes

• GroupLifecycleController for primer/follower orchestration
• WorkStealingScheduler and pool configuration
• event bus primitives and JSONL-friendly event emission
• cache registry and cache-handle propagation support
• development executors such as NoopExecutor, EchoExecutor, and SimulatedExecutor

Logging

acty-core uses structlog. For readable local logs and rich tracebacks:

from acty_core import configure_logging

configure_logging(handler="rich", show_locals=True)

Cache Behavior

When a group uses a cache registry, the lifecycle attaches the resolved cache handle to queued jobs as job.cache_handle. Executors can reuse provider metadata from the cache handle instead of creating duplicate cache entries.

Development

• tests live under tests/
• example programs live under examples/
• the package is intentionally usable without the higher-level acty TUI layer