Install terminaI
Get started in under 2 minutes.
TerminaI is self-hosted. We don't operate cloud servers or telemetry.
Prerequisites
- • Node.js 18+ (check:
node --version) - • Git (for source install only)
- • Supported platforms: Linux, macOS, Windows
NPM Install (Recommended)
Install globally via npm.
# Install globally
npm install -g @terminai/cli
# Run
terminai
Build from Source
Independent open-source fork; not affiliated with Google.
# Clone the repository
git clone https://github.com/Prof-Harita/terminaI.git
# Build
cd terminaI && npm ci && npm run build
# Link globally
npm link --workspace packages/termai
# Run
terminai
Quick start (providers)
Run terminai and the wizard guides you through setup.
Google GeminiDefault
Fastest path for many users.
terminai
# Select "Google Gemini" → browser opens → sign in
Or use an API key:
export TERMINAI_API_KEY="your-gemini-key"
terminai
ChatGPT sign-in (OAuth)Preview
Use an OpenAI browser sign-in flow (similar to how Codex tooling supports "Sign in with ChatGPT").
terminai
# Select "ChatGPT Sign-in (OAuth)" → sign in with OpenAI
Note: this is still being hardened. If anything fails, attach logs (see below) and open an issue.
OpenAI-Compatible
Connect to OpenAI Platform, OpenRouter, Ollama gateways, or any /chat/completions endpoint.
export OPENAI_API_KEY="sk-..."
terminai
# Select "OpenAI Compatible" → enter base URL and model
Popular configurations:
- OpenAI: https://api.openai.com/v1
- OpenRouter: https://openrouter.ai/api/v1
- Local LLM: http://localhost:11434/v1
Optional: Voice Mode
Install offline voice (downloads ~200MB, runs forever offline).
terminai voice installThen use terminai --voice or hold Space to talk in Desktop app.
You're ready to go!