littlehive 0.5.4

LittleHive local-first multi-agent assistant foundation

LittleHive

LittleHive is a local-first, multi-model, multi-agent assistant platform optimized for small local models, strict context budgets, and low operating cost.

Core Concepts

• ITR (Instruction-Tool Retrieval): only inject compact tool docs until invocation time.
• Memory Cards: typed compact reusable memory units, not full transcript replay.
• Transfer Primitive: clean-state handoffs between agents.
• Context Compiler: central token-budget preflight + deterministic trimming.

Install

pip install littlehive
pip install "littlehive[telegram]"
pip install "littlehive[ui]"
pip install "littlehive[full]"

For development:

pip install -e ".[dev,telegram,ui]"

Quickstart

1. Start LittleHive:

lhive run
# or: lh-run

This will:

• run quick onboarding on first launch (if config is missing),
• load .env,
• start API, dashboard, and Telegram worker (when enabled and token is present),
• keep supervisor off by default to reduce console noise,
• print the local dashboard URL.

For full power-user onboarding prompts:

lhive run --advanced
# or: littlehive-run --advanced

To reset local setup and start fresh:

lhive reset
# or: lh-reset

2. Optional diagnostics:

littlehive-diag --validate-config --hardware --check-providers

Advanced/manual control CLIs are still available (see below).

Dashboard

littlehive-dashboard is Python-only (NiceGUI), no Node/React install required.

Main views:

• Overview
• Providers (health + breaker + routing score)
• Tasks/Traces
• Memory search
• Permissions and power controls
• Usage/Budgets
• Diagnostics/Failures
• Pending confirmations

Safety and Permission Profiles

Supported permission profiles:

• read_only
• assist_only
• execute_safe
• execute_with_confirmation
• full_trusted

Risk levels (low|medium|high|critical) are enforced in tool execution. Medium/high actions can require confirmations depending on profile and safe mode.

Diagnostics

littlehive-diag --provider-health
littlehive-diag --failures
littlehive-diag --runtime-stats
littlehive-diag --budget-stats

CLI Entrypoints

• lhive (short command: lhive run, lhive reset, lhive diag)
• lh-run (short alias)
• lh-reset (short alias)
• littlehive-run (recommended for end users)
• littlehive-onboard
• littlehive-api
• littlehive-telegram
• littlehive-diag
• littlehive-dashboard
• littlehive-supervisor
• littlehive-reset

Development

pytest -q
python -m build
twine check dist/*

Limitations

• Dashboard auth is currently basic token gating; default host binding is localhost.
• Provider/tool telemetry is compact summaries by design (no full raw payload dump).

Roadmap

Phase 6+: richer admin auth, stronger benchmarking, and broader channel/runtime controls.