Agent Zero for Cloudron

This repository packages Agent Zero for Cloudron as a clean upstream v2.7 deployment with only Cloudron filesystem, process, and persistence adaptations.

Features

• Personal AI Agent: Grows and learns with you.
• Upstream-Based: Tracks standard upstream Agent Zero v2.7 without legacy compatibility layers.
• Cloudron-Friendly: Respects read-only /app/code and persists writable state under /app/data.
• Cloudron Integration:
  • Authentication: Uses Agent Zero's built-in login.
  • Storage: Persists writable app state in /app/data.
  • Security: Runs as the cloudron user.

Usage

1. Install the app on your Cloudron.
2. Open the app URL.
3. Log in with the credentials created on first run in /app/data/agent-zero-initial-credentials.txt.
4. Configure your providers and plugins in the upstream Agent Zero settings UI.

Configuration

API Keys

You can configure API keys and login credentials in the application settings or by editing /app/data/usr/.env.

Persistent Paths

This package persists the writable Agent Zero paths in /app/data:

• conf/
• extensions/python/
• knowledge/
• logs/
• prompts/
• tmp/
• tools/
• usr/

The default workspace is /app/data/usr/workdir. Project workspaces created in the Agent Zero UI are stored in /app/data/usr/projects.

First-Run Login

On first startup, the package creates fresh Agent Zero credentials if AUTH_LOGIN and AUTH_PASSWORD are not already defined in /app/data/usr/.env.

• Username defaults to admin.
• A random password is generated and written to /app/data/agent-zero-initial-credentials.txt.
• You can later rotate both values by editing /app/data/usr/.env.

Development

Package versioning and build/publish steps are handled by the user’s release scripts.

License

This package is licensed under the MIT License, matching the upstream Agent Zero project.