English · Español
Aleph
Freedom to create.
Build your own AI agents, piece by piece, in The Workshop.
No code required. You place a model on a live board, plug in the tools it needs, test every piece and watch your agent come to life. Then you put it to work on your Mac.
One space. Infinite work.
Website ·
Build an agent ·
Watch the trailer ·
Install ·
How to use it ·
Getting Started
The Workshop. Every piece you add shows up on the board. Agents can hold other agents, and you can step inside any of them to shape it.
Building your own AI workspace?
Your agent, your way
| | |
|---|
| 🧠 | Start with a Core | Pick its model, give it an identity and a goal. That's your agent. |
| 🧩 | Equip pieces | Add tools from the catalog, or describe what you want in your own words and let the Guide propose them. |
| 🔌 | Open the MCP door | Connect an app with OAuth or a key, and its real tools drop onto the board as pieces you can equip. |
| 🟢 | Test every piece | Each piece tells you whether it's verified, untested or broken, and why, so you know before you rely on it. |
| 🔒 | Stay in charge | Anything that reaches the outside world, like email or messages, passes through a lock that asks for your OK first. |
| ▶️ | Save it. Run it. | Your agent lands in My agents. Put it to work in The Room. |
Why Aleph
Your AI work is scattered: one app for chat, another for files, a terminal for the CLI agent, a browser tab for every service. Aleph puts it in one space, and lets you build the agents that work in it.
Watch the trailer
https://github.com/user-attachments/assets/ad208351-a6ba-4cf1-8096-6173cb717ee8
55 seconds. Can't see the player? Download the trailer.
A look inside
Screenshots come from a development build of Aleph (September 2026), so details may differ from the 0.1.2 release. The illustration is a product concept, not a screenshot.
The spaces
| Space | What it's for |
|---|
| 💬 The Room | Conversations and general work with an agent |
| 🛠️ The Workshop | Compose agents: pick a model, give it a goal, equip its tools |
| 📄 Office | Documents, spreadsheets and presentations |
| 📈 Finance | Analysis and markets |
| 🎓 Education | Study and learning |
| 🔬 Science | Research and evidence |
| 🎨 Design | Ideas and visual work |
| ⚖️ Legal | Review and documents |
In Spanish, The Room is La Sala and The Workshop is El Cuarto.
Install
macOS · Apple silicon
- Download
Aleph-macOS-arm64.dmg.
- Open the DMG.
- Drag Aleph.app to Applications.
- Open Aleph from Applications.
Or with Homebrew:
brew install --cask josuecuguy1307/tap/aleph
[!NOTE]
Aleph 0.1.2 is ad-hoc signed and not notarized, so macOS may block the first open. Try to open it once, then go to System Settings → Privacy & Security → Open Anyway (Apple's instructions). Only do this for a download from this official release. Homebrew installs the same app, with the same prompt.
How to use Aleph
| Step | What you do |
|---|
| 1 | Open Aleph | Follow the setup prompts and choose your language (English or Español). |
| 2 | Choose your model | Connect an API provider with your own credentials, or pick an installed and signed-in CLI such as Claude Code or Codex. |
| 3 | Start in The Room | Pick an agent, describe what you want, and open the files and artifacts it produces. |
| 4 | Open a workspace | Science, Education, Office, Finance, Legal or Design, depending on the work in front of you. |
| 5 | Make it yours in The Workshop | Compose agents, equip tools and arrange workflows you can come back to. |
Continue with Getting Started →
Your models. Your tools.
Bring the provider you want and connect the services your work needs. Models, CLI agents and connectors are separate capabilities: connecting one does not authorize the others.
| Models and CLI providers | Connected tools |
|---|
| |
[!IMPORTANT]
Aleph is model-agnostic, and what you can use depends on your machine. Available models depend on your installed providers, sign-ins and access limits, and connectors may need installation, an API key or OAuth before they work. These illustrations show product concepts, not a promise that every integration is ready. Onshape is optional and not certified.
Build from source
See BUILDING.md for prerequisites, the official build path and current reproducibility limitations.
Open source
Aleph-owned source is licensed under Apache-2.0. Third-party components keep their own licenses; see THIRD_PARTY_NOTICES.
The Aleph name, logo, mascot and official branding, including the product imagery in this README, are covered separately by TRADEMARKS.md and are not granted by Apache-2.0. Forks may describe their origin factually, but must not imply official status or endorsement. Image provenance.
Want to contribute? Start with CONTRIBUTING.md.
Current release
0.1.2 · macOS installer and source release
The release page separates the macOS installer from the developer-only guest assets. The exact guest kernel, root filesystem and matching third-party source bundle are also available there. Guest asset details and compliance remain available for developers; full guest-image regeneration from source is not yet claimed. Don't use the guest kernel or root filesystem as the macOS installer.
The certified source baseline and snapshot scope are recorded in SOURCE_PROVENANCE.json. This README is the product-facing introduction; the immutable v0.1.2 tag preserves the original certified snapshot.
