Installation

One small command-line tool. Your course files stay in a folder you choose.

Install Agent2Learn

Choose one of the three supported methods. Run it in your own terminal; no administrator permissions are required for the Agent2Learn install.

If uv is new to you, choose your operating system. Its installer takes care of uv too.

Already have uv

Install Agent2Learn with uv, then start guided setup:

uv tool install agent2learn
a2l init

macOS / Linux

The installer sets up uv if needed, installs Agent2Learn, and continues into setup in an interactive terminal.

curl -fsSL https://raw.githubusercontent.com/ManagementMO/agent2learn/v0.1.2/install.sh | bash

Windows

Run this in PowerShell. The installer handles uv and your PATH, then continues into interactive setup.

irm https://raw.githubusercontent.com/ManagementMO/agent2learn/v0.1.2/install.ps1 | iex

The engine targets Windows, macOS, and Linux with Python 3.11–3.14. uv installs it in an isolated tool environment. Node.js is not needed to use Agent2Learn.

If a platform installer runs without an interactive terminal, it installs and verifies the engine, then prints the next command. Open a terminal and run a2l init yourself.

Create your vault

a2l init

Setup walks you through:

1. Your folder. Preview and approve the vault location. Keep it outside a public Git repository or shared folder.
2. Your agent. Choose whether to install the four Agent2Learn skills. You see the destinations before anything is written.
3. Your sign-in. Complete WatIAM and Duo yourself in the dedicated Chrome or Edge window.
4. Your courses. Choose a term and courses from your own enrolment.
5. Your first sync. See course metadata and deadlines, then choose full documents, a smaller priority selection, or files later.

Grades and discussions are off by default. If setup is interrupted, rerun a2l init to resume.

Check the installation

a2l --version
a2l doctor

doctor explains the local checks and gives you one next command if something needs attention. If your terminal cannot find a2l, open a new terminal first; an existing one may still have the old PATH.

Start using it

a2l today
a2l sync

today reads local deadlines and changes. sync refreshes the courses you selected. Continue with your first sync or studying with sources.

Optional conversion support

PDF conversion is included. Scanned pages need an external Tesseract installation; a2l doctor tells you whether it is available. A missing converter is recorded as a coverage gap.

The Python package also offers office and notebook extras. The Office extra currently requires Python 3.11–3.13 because of a dependency’s wheel support. See the repository package configuration for those optional dependencies.