Get the source
git clone https://github.com/vxsxxn/Aa.git
A desktop AI agent you stay in charge of
Aa builds with you — code, sites, and day-to-day work. It started as a fork of Hermes Agent and is becoming its own project.
Install from source
git clone https://github.com/vxsxxn/Aa.git cd Aa pip install -e . Aa
Get started
Run Aa on your machine
Python 3.11–3.14. The CLI entry point is Aa.
Editable install
cd Aa && pip install -e .
Start chatting
Type Aa in your terminal.
Features
What’s in Aa
Desktop settings, an approvals UI, a secret vault, and a mods system — built on the Hermes Agent base.
01 · Settings
Desktop settings
Configure the agent on your machine.
02 · Approvals
Approvals UI
Review and allow actions before they run.
03 · Vault
Secret vault
Keep credentials out of plain files and chat.
04 · Mods
Mods system
Extend Aa without rewriting the core.
How it works
You keep the wheel
You stay in charge
Every action needs your approval before it runs.
No lock-in
Your data stays portable and open. Leave whenever you want.
Free will
Aa helps; it doesn’t take the wheel.
FAQ
Common questions
What is Aa?
A desktop AI agent for building things — code, sites, and day-to-day work. It is a fork of Hermes Agent by Nous Research and is becoming its own project.
How do I install it?
Clone the repo, run pip install -e ., then start with Aa.
Needs Python 3.11–3.14.
Is it open source?
Yes. MIT License. Based on Hermes Agent by Nous Research — keep the credit.