open-swarm 0.1.1745274942__py3-none-any.whl → 0.1.1745275181__py3-none-any.whl

swarm/blueprints/jeeves/README.md

@@ -0,0 +1,41 @@
+# Jeeves Blueprint
+
+**Jeeves** is a multi-agent home and web orchestration blueprint for Open Swarm, demonstrating multi-agent delegation for web search and home automation, robust fallback for LLM/agent errors, and unified ANSI/emoji UX with spinner feedback.
+
+---
+
+## What This Blueprint Demonstrates
+- **Multi-agent delegation and orchestration** for web search and home automation
+- **LLM fallback and error handling** with user-friendly messages
+- **Unified ANSI/emoji boxes** for operation results, including summaries, counts, and parameters
+- **Custom spinner messages**: 'Generating.', 'Generating..', 'Generating...', 'Running...'
+- **Progress updates** for long-running operations (result counts, summaries)
+- **Test mode** for robust, deterministic testing
+
+## Usage
+Run with the CLI:
+```sh
+swarm-cli run jeeves --instruction "Turn off the living room lights and search for pizza recipes."
+```
+
+## Test
+```sh
+uv run pytest -v tests/blueprints/test_jeeves.py
+```
+
+## Compliance
+- Agentic: 
+- UX (ANSI/emoji): 
+- Spinner: 
+- Fallback: 
+- Test Coverage: 
+
+## Required Env Vars
+- `SWARM_TEST_MODE` (optional): Enables test mode for deterministic output.
+
+## Extending
+- See `blueprint_jeeves.py` for agent logic and UX hooks.
+- Extend agent capabilities or UX by modifying the `_run_non_interactive` and agent orchestration methods.
+
+---
+_Last updated: 2025-04-21_