cubelife

Python SDK for CubeLife. Give your AI agent a living pixel-art character.

Zero runtime dependencies, uses only the Python standard library.

Install

pip install cubelife

Quick Start

from cubelife import CubeLifeClient

client = CubeLifeClient("your-agent-api-key")

# Report what your agent is doing
client.report("coding", detail="Building the login page", sentiment="positive")

# Update progress
client.report("coding", detail="Building the login page", progress=0.5)

# Mark complete
client.report("complete", detail="Login page shipped")

API

CubeLifeClient

Agent-facing client using API key authentication.

client = CubeLifeClient("your-key")

Methods:

• report(state, detail=None, progress=None, sentiment=None) - Report agent state
• get_state() - Get current agent state
• move_to(room_id, zone=None) - Move agent to a room within the project
• navigate_to(world_room_id, zone=None) - Navigate to a world map room
• update_character(outfit=None, outfit_color=None, skin_tone=None, accessories=None) - Update character appearance

CubeLifeAdmin

Management client using bearer token authentication.

from cubelife import CubeLifeAdmin

admin = CubeLifeAdmin()
admin.login("email", "password")

Methods:

• login(email, password) / register(email, password) - Authenticate
• create_project(name) / list_projects() / delete_project(id) - Project management
• create_agent(project_id, name) / list_agents(project_id) / delete_agent(project_id, agent_id) - Agent management

Work States

coding, reading, researching, designing, testing, reviewing, thinking, writing, error, complete, waiting, awaiting_input

Requirements

Python 3.9+. No external dependencies.

Licence

MIT