"Don't just fix the code. Evolve the coder."
⬇ Download the latest Windows release
No Java install needed. It's bundled in the download (about 170 MB zipped, about 324 MB unzipped).
Voice activation is currently unavailable. AMADEUS uses Picovoice Porcupine for wake-word detection. Picovoice's free-tier AccessKeys stopped working after June 30, 2026, and the company is shifting to an enterprise (B2B) model, so wake words can't start with a free key. Use the TEST button in the app to trigger each mode instead (see Using the TEST button). Replacing the wake-word engine is on the roadmap.
- Download
AMADEUS-0.1.0-windows.zipfrom the Releases page and unzip it. - Get a free Gemini API key from Google AI Studio.
- Open the
.envfile inside the unzippedAMADEUSfolder in Notepad, paste your key after the=, and save:LeaveGEMINI_API_KEY=your_gemini_key_herePV_API_KEYblank unless you have a working Picovoice key (see Known limitations). - Run
AMADEUS.exe. - Copy some code, click TEST to pick a mode, and read the answer in the popup.
Windows SmartScreen may warn about an unknown app because the build isn't code-signed. Click More info, then Run anyway.
Keep your keys private. Never share your .env file or post screenshots of it.
Beginner coders are becoming overly dependent on AI for debugging and logic building. We can't realistically stop beginners from using AI, but we can influence how they use it.
AMADEUS puts a price on AI help. Every request costs points, points are earned slowly over time, and the more hand-holding you ask for, the more it costs. The goal is to nudge you toward working through problems yourself.
AMADEUS is a Windows-only Java desktop assistant (JavaFX) designed to be triggered by voice. See the note above: voice activation currently needs a valid Picovoice key, so the in-app TEST button is the way to trigger it for most users.
- Trigger: Picovoice Porcupine listens offline for one of three voice commands (Arise, Ascend, Absolute). Each command is its own wake word and also selects the help tier. (The TEST button triggers the same three modes without voice.)
- Capture: On a match, AMADEUS reads the text currently in your clipboard (copy your code first).
- Analyze: The code is sent to a Google model, with a system prompt specific to the tier you asked for. The model is chosen per tier (see below).
- Respond: The answer streams into a popup window, formatted as Markdown.
A 25-second cooldown applies between voice triggers, so one command isn't fired twice by accident.
- Starting balance: 500 EXP.
- Passive gains: EXP is added automatically on a timer: a random 40-49 EXP (picked once per launch) every 60 seconds, starting 5 seconds after launch. Gains are time-based, not activity-based; AMADEUS does not currently detect what you're doing.
- Spending: Each command deducts its cost before the request is sent. If your balance is lower than the cost of the command, the request is refused with a "Low EXP" message and nothing is deducted. Once deducted, the cost is not refunded if the request fails (for example, an empty clipboard or an API error).
- Levels: Your avatar evolves with your EXP, and drops back down if you spend below a threshold. "LEVEL UP" / "LEVEL DOWN" notifications appear on level changes (except when climbing out of level 0).
| Level | EXP range |
|---|---|
| 0 | below 500 |
| 1 | 500 - 799 |
| 2 | 800 - 1200 |
| 3 | 1201 - 1800 |
| 4 | above 1800 |
- Persistence: EXP is held in memory only. It resets to 500 each time the app starts.
| Command | Cost | Model (as configured in Ai.java) |
Description |
|---|---|---|---|
| "Arise" | 50 EXP | gemini-3.1-flash-lite |
Mentor Mode. Finds the most critical issue, gives the line number and reasoning, and one actionable hint. Refuses to write the fix. |
| "Ascend" | 100 EXP | gemini-3.6-flash |
Guide Mode. Diagnoses the error and gives a step-by-step conceptual guide. Pseudo-code or small snippets are allowed, but not the full corrected block. |
| "Absolute" | 250 EXP | gemma-4-26b-a4b-it |
God Mode. The last resort. Lists every fix and returns the full corrected code. |
Example: Level 1 Alpha Avatar
NOTE: AI has been used for all art.
The avatar window has a small TEST button (bottom right) that cycles through Arise, Ascend and Absolute and triggers each one without voice. It follows the same cost rules as a spoken command. Because voice activation is currently unavailable without a valid Picovoice key, this is the main way to use AMADEUS.
If you only want to use AMADEUS, the Download section above is all you need. This section is for building it yourself.
- Windows. AMADEUS currently runs on Windows only.
- JDK 24 or higher.
- Maven 3.9+, or the Maven support built into IntelliJ IDEA.
- Google Gemini API Key (Google AI Studio).
- Picovoice Access Key (optional, for voice activation only). Free-tier keys no longer work, so wake words need a key from a paid or enterprise plan. See the Picovoice Console.
- A working microphone (only needed for voice activation).
- An internet connection (needed for the Gemini API and for the response window's Markdown and syntax-highlighting libraries).
git clone https://github.com/D3ICIDE/AMADEUS.git
cd AMADEUSCreate a .env file in the project root (the directory you run the app from). The .env_example file in the project root shows the format:
GEMINI_API_KEY=your_gemini_key_here
PV_API_KEY=your_picovoice_key_here
PV_API_KEY can stay blank if you don't have a working Picovoice key. The app will print a Porcupine error at startup and carry on, and you can use the TEST button instead.
Environment variables with the same names take priority over the .env file, so if a key you've set in Windows or your IDE is outdated, it will override what's in the file.
This only matters if you have a working Picovoice key. Porcupine needs to load the keyword (.ppn) files from your local file system.
- Keyword files: The repo bundles the Windows keyword files for Arise, Ascend and Absolute under
models/. Keep them where they are: their paths are hardcoded inVoiceRecognition.javaand are relative to the directory you run the app from.
mvn clean compileThen run the Launcher class from your IDE (it starts the JavaFX Ui application). Run it from the project root so the .env file and the models/ folder are found. A javafx-maven-plugin is not configured yet, so mvn javafx:run is not available.
- Voice activation is currently unavailable for most users. Picovoice's free-tier AccessKeys stopped working after June 30, 2026, and the company is focusing on enterprise (B2B) customers. Use the TEST button as a fallback.
- Replace the wake-word engine with an alternative that doesn't depend on a paid key.
- EXP persistence across launches.
- Configurable keyword path instead of hardcoded constants.
- Maven run target (
javafx-maven-plugin). - Smaller release download by shipping a trimmed Java runtime instead of a full JDK.