Your first session
Start with a task. You do not need to build an agent before using Aleph. These steps follow the public getting started guide.
Install and open
Section titled “Install and open”Aleph 0.1.2 is available for macOS on Apple silicon (arm64). Download the app from the download page, verify its SHA-256, open the DMG, and drag Aleph.app to Applications.
The app is ad-hoc signed and not notarized. Follow the installation guide for the macOS first-open prompt and Homebrew alternative. Release assets such as guest kernels and root filesystems are for developers, not app installers.
Open Aleph and follow setup, including your preferred language.
Connect a provider
Section titled “Connect a provider”Open the model selector and choose the provider you want to use.
- API provider: configure your own credentials where requested.
- CLI provider: install the CLI, authenticate it, and then select it in Aleph. The public guide describes Claude Code and Codex paths.
Provider subscriptions, access permissions, and usage limits still apply. A visible option in the selector does not confirm that it is installed, authenticated, or ready to execute. Local Qwen 8B model weights are not included in the DMG and require separate provisioning.
See models and agents for the distinction between a model, an agent, and a connected capability.
Your first task
Section titled “Your first task”Use Home to navigate, then La Sala to work with an available agent. Describe what you want to do and which files or context should inform it. Review the actions, files, and artifacts produced as the work proceeds.
For example, begin with a small task such as organizing notes into an outline. This is a starting idea rather than a promise of a particular tool operation; available capabilities depend on the build and provider setup.
Choose a focused workspace
Section titled “Choose a focused workspace”Explore Science, Education, Office, Finance, Legal, or Design for a domain-oriented starting point. The homepage explorer introduces each workspace with an example prompt.
Make an agent of your own
Section titled “Make an agent of your own”In The Workshop (English) or El Cuarto (Spanish), choose a model, define an identity and goal, and equip the tools the agent needs. Save it, then use it in La Sala. Read The Workshop guide for the composition steps.
Connect tools deliberately
Section titled “Connect tools deliberately”Some capabilities need local software; others need an API key or an account authorization flow. Follow the connector’s setup and check its test result. Model authorization does not authorize your other services.
Local work and connected operations have different data boundaries. See local runtime and data and connectors and capabilities. Onshape remains optional / not certified.