Autonomous (Local) Example

This folder contains three minimal, sandboxed “always-on” autonomous loop examples (TypeScript, Python, Rust) that all follow the same pattern:

1. Think using plugin-local-ai (local GGUF inference)
2. Optionally act using plugin-shell (restricted directory)
3. Record observations using plugin-inmemorydb (ephemeral, in-process)
4. Repeat until stopped

Safety / guardrails

These demos are intentionally sandboxed:

• Shell is directory-restricted: set SHELL_ALLOWED_DIRECTORY to a dedicated sandbox folder.
• Default command allowlist: the examples only allow a small set of basic commands (you can expand it).
• Kill switch: create a STOP file inside the sandbox directory to stop the loop.

Model Setup (Eliza-1 GGUF)

Download the Eliza-1 mobile GGUF and place it in your models directory.

• Model repo: elizaos/eliza-1
• GGUF file: bundles/2b/text/eliza-1-2b-32k.gguf

Then set:

export MODELS_DIR="$HOME/.eliza/models"
export LOCAL_SMALL_MODEL="eliza-1-2b-32k.gguf"

Notes:

• The TypeScript plugin-local-ai implementation can auto-download its default models. For this example, pre-download the Eliza-1 mobile GGUF and set LOCAL_SMALL_MODEL to the exact filename.
• Python and Rust examples expect the GGUF file to already exist (no auto-download).

Shell sandbox setup

Pick a safe directory (example below uses this repo’s examples/autonomous/sandbox):

export SHELL_ALLOWED_DIRECTORY="$(pwd)/examples/autonomous/sandbox"
export SHELL_TIMEOUT=30000

# Recommended extra restrictions (network/process control, etc.)
export SHELL_FORBIDDEN_COMMANDS="curl,wget,ssh,scp,rsync,nc,socat,python,node,bun,kill,pkill,killall,shutdown,reboot"

Create the sandbox directory if it doesn’t exist:

mkdir -p "$SHELL_ALLOWED_DIRECTORY"

Run

TypeScript

cd examples/autonomous
bun install
bun run start

Python

cd examples/autonomous/python
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python autonomous.py

Rust

Note: The Rust example requires elizaos-plugin-local-ai with the llm feature enabled for actual inference. This feature depends on a vendored llama_cpp_rs crate that is not yet included in the repository. The example will compile but exit early with an error message until the vendor is added. See the plugin's Cargo.toml for details.

cd examples/autonomous/rust/autonomous
cargo run --release