plutus-ai

library0.3.280pypypiunverified

Plutus AI is an autonomous AI agent framework designed for local execution, featuring subprocess orchestration, dynamic tool creation, and a local-first web interface. It allows users to define and run AI agents on their own machines, leveraging external LLMs. The current version is 0.3.240, and the library is in active development with frequent (often daily) releases.

llm-agents ai-ml

pip install plutus-ai

github ↗package ↗

INSTALL

IMPORT

SIG · PLUTUS-AI

plutus-ai

llm-agentspythonv0.3.280

Install

24.3s avg

Import

—

Disk

352MB

Pass rate

6/ 10

Env Coverage6 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.3.26 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

py 3.11

✓ —

✓ 26.75s

py 3.12

✓ —

✓ 22.88s

py 3.13

✓ —

✓ 23.13s

py 3.9

✕ build_error

352MB installed

● package 352MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Agent

✓ from plutus import Agent

✗ from plutus import Agent

This quickstart demonstrates how to programmatically define an Agent and a Goal object using the Plutus AI library. It highlights the primary use of these classes for defining agent behaviors and tasks. To execute agents, the Plutus CLI (`plutus run` or `plutus chat`) or the local web UI is typically used, as the `Agent` class itself is a definition rather than an executor.

from plutus import Agent, Goal import os # Good practice for potential environment variables # Define an agent specification as a dictionary agent_spec = { "name": "SimpleGreeterBot", "instructions": "You are a friendly bot that greets the user and introduces yourself.", "goals": ["Greet the user, introduce yourself, and then finish the conversation."], "tools": [], } # Instantiate the Agent and Goal definitions from the plutus library agent = Agent(spec=agent_spec) goal = Goal(description="Say hello to the user and finish the task.") print(f"Successfully defined Agent: '{agent.name}'") print(f"Instructions: '{agent.instructions}'") print(f"Goal: '{goal.description}'") # Note: To *run* this agent, you typically use the Plutus CLI, for example: # 1. Ensure the agent spec is accessible (e.g., saved via Plutus UI or a YAML file). # 2. Run from your terminal: `plutus chat --agent SimpleGreeterBot --goal "Say hello!"` # Or `plutus run --agent SimpleGreeterBot --goal "Say hello!"`

Debug

Known issues

gotchaPlutus AI is currently in a pre-1.0 development phase (version 0.3.x). Expect frequent breaking changes to agent specifications, API interfaces, and core functionalities between minor versions.

fix

Always review the latest GitHub README and example code when upgrading to a new minor version. Pin your `plutus-ai` dependency to a specific patch version (e.g., `plutus-ai==0.3.240`) in production environments.

affects: <1.0.0

gotchaThe `Agent` and `Goal` classes are primarily for defining agent specifications and tasks. They do not have simple `.run()` methods for direct programmatic execution. Agent execution is typically managed via the `plutus` CLI or the local web interface.

fix

To run an agent defined in Python, you often need to save its spec (e.g., to YAML) or pass it via CLI arguments, then invoke the `plutus` command (e.g., `plutus run --agent MyAgent --goal "Do something"`). Consider the library for definition and the CLI/UI for orchestration.

affects: All versions

breakingPlutus AI requires Python 3.11 or higher. Running with older Python versions (e.g., 3.10 or 3.9) will result in installation failures or runtime errors due to syntax or dependency incompatibilities.

fix

Upgrade your Python environment to version 3.11 or 3.12. Using a tool like `pyenv` or `conda` can help manage multiple Python versions.

affects: <0.3.x

gotchaPlutus AI relies on external Large Language Models (LLMs) and requires appropriate API keys to be configured as environment variables (e.g., `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`). Without these, agents will fail to interact with LLMs.

fix

Ensure the necessary LLM API key environment variables are set in your shell or `.env` file before launching Plutus. Refer to the specific LLM provider's documentation for required keys.

affects: All versions

Upgrade

Version history

0.3.280latest on PyPI · released May 29, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/plutus-ai/plutus ↗

packagehttps://pypi.org/project/plutus-ai/ ↗