Aleph

Aleph documentation

Aleph is a platform for adopting and running versioned AI agents. Start with an agent that already works, inspect what it needs, install its live source into your own scope, and enable it when your configuration is ready.

The shortest path to a working agent

The primary lifecycle is designed around six steps:

  1. Discover. Browse public agents and choose one built for the work you need.
  2. Inspect. Review its instructions, tools, schedules, and permission requirements.
  3. Install. Add a live installation that shares source memory and follows the source harness.
  4. Authorize. Add your own secrets, variables, Connections, and channels when requested.
  5. Enable. Turn on your installation so chat, schedules, and channels can run it.
  6. Run. Use it while retaining control of your own runtime state.

You do not need to rebuild an agent just to use it. The source bundle remains inspectable and read-only in an installation. Your installation gets its own placement, permissions, conversations, channels, and enable/disable state. If you need to change code, choose Clone independently for an editable fork that does not receive source updates.

What an agent includes

An Aleph agent combines a versioned bundle with platform-managed runtime state.

  • Bundle files describe instructions, sandbox behavior, schedules, and configuration references.
  • Versions make published agent behavior inspectable and repeatable.
  • Vault entries and variables supply configuration without placing secret values in the bundle.
  • Conversations persist outside the immutable bundle; shared memory lives in versioned memory/ files.
  • Schedules and channels let an enabled agent work without an open browser tab.
agent bundle + scoped configuration + enabled version
                         ↓
              chat, schedules, channels

Consumers and creators

Most people begin as consumers: they discover an agent, inspect it, install it, authorize their own access, and put it to work. Creators publish Git-first bundles for others to inspect and adopt. The same versioned structure connects both sides.

Where to go next

Open the Quickstart for the guided adoption path. If you plan to publish agents, begin with Bundle structure.