generalagents 0.1.0

General Agents client library

General Agents Python API client

Documentation

The REST API documentation: https://docs.generalagents.com/

Installation

General Agents Python API client is available as a python package on PyPI:

pip install generalagents

# or with uv
uv add generalagents

Usage

This client includes both an interface for calling the agent, and a simple computer controller. An example execution loop:

import os

from generalagents import Agent
from generalagents.macos import Computer

agent = Agent(model="ace-small", api_key=os.getenv('GENERALAGENTS_API_KEY'))
computer = Computer()

instruction = "Star the generalagents-python github repository"
session = agent.start(instruction)
observation = computer.observe()

for _ in range(50):  # max actions
    action = session.plan(observation)
    if action.kind == "stop":
        break
    observation = computer.execute(action)

Contributing

See the contributing documentation.