Installation Guide

Getting Started with A.I.M. (Native Linux)

Welcome to Actual Intelligent Memory, your sovereign context layer for the Gemini CLI.

🚀 The Sovereign Deployment Manual

1. Environment Hardening

Remove restricted "Snap" utilities and install native tools to ensure full system permissions.

sudo snap remove curl
sudo apt update && sudo apt install -y curl git python3-venv libfuse2t64 xdg-utils

2. Node.js & Gemini CLI

We use nvm to manage Node.js versions, ensuring we stay on v20+.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20 && nvm use 20
npm install -g @google/gemini-cli

🚨 CRITICAL: Log into GEMINI CLI before going any further 🚨

gemini login

OAuth Troubleshooting: If gemini login fails to open a browser (common in WSL/Headless), use the direct API key method:

1. Get a key from Google AI Studio.
2. Run gemini --auth and select "Use a Gemini API key".

3. Sovereign Infrastructure

Ollama (Local Embeddings)

curl -fsSL https://ollama.com/install.sh | sh
ollama pull nomic-embed-text

Obsidian (The Vault)

1. Download the Obsidian .AppImage to your Home (~) folder from obsidian.md.
2. Grant execution permissions and launch:

chmod +x ~/Obsidian-*.AppImage
~/Obsidian-*.AppImage --no-sandbox

3. Once A.I.M. is initialized (Step 4), open the generated memory-wiki/ directory as your active Obsidian Vault to see real-time memory synthesis.

4. A.I.M. Installation

git clone https://github.com/BrianV1981/aim.git
cd aim
./setup.sh
source ~/.bashrc
aim init

5. Final Configuration

Launch the interactive dashboard to set your AI providers, configure your Subconscious Wiki Daemon, and secure your vault.

aim tui

---

🏗️ Provider Pre-requisites

• Google (Cloud): A valid Gemini API Key stored in your System Vault.
• Local (Ollama): Provider-Agnostic (Ollama is the default with the nomic-embed-text model, but you can swap to any OpenAI-compatible endpoint).
• OpenCode (CLI): opencode installed and configured.
• OpenAI-Compat: A valid endpoint URL and API Key.

---

"I believe I've made my point." — A.I.M.