Skip to main content

The ultimate AI coding assistant — multi-provider, cross-platform, terminal-native.

Project description

⚡ QuickVibeAI

The Ultimate AI Coding Assistant — Multi-Provider, Cross-Platform, Terminal-Native.

QuickVibeAI is a powerful CLI-based AI coding assistant that helps you build modern web applications. It understands your project structure, reads your files, generates code, and executes commands — all while keeping you in total control.

🚀 Features

  • 27+ Free Models: Updated free model list from OpenRouter (GPT OSS 120B, Gemma 4, Qwen3 Coder, Nemotron, Llama 3.3, and more).
  • Multi-Provider Support: Switch between OpenRouter, Groq, and Native Gemini via a beautiful local control panel.
  • Cross-Platform: Works on Windows, Linux, macOS, and Termux (Android).
  • Project Aware: Automatically maps your directory tree to provide full context to the AI.
  • Native File Operations: Creates, reads, and deletes files directly within your project.
  • Smart Command Execution: Runs dev servers, installs dependencies, and manages builds with user confirmation.
  • Beautiful UI: Powered by Rich and Prompt-Toolkit for a premium terminal experience.

🛠️ Installation

From PyPI (Recommended)

pip install quickvibeai

From Source

git clone https://github.com/devnathani16/QuickVibeAI.git
cd QuickVibeAI
pip install -e .

Termux (Android)

pkg install python rust
pip install quickvibeai

⌨️ Usage

Launch QuickVibeAI from any project directory:

quickvibeai

First-Time Setup

quickvibeai --setup

This will guide you through API key configuration and model selection.

Options

Flag Description
--setup Run interactive setup (API key + model)
--dir PATH Set project directory
--version Show version

Commands Inside QuickVibeAI

Command Description
/tree View the full project file structure
/models List all available free models
/clear Clear the local chat history
exit Quit the application

🌐 Web Control Panel

When QuickVibeAI starts, it launches a local web panel at http://127.0.0.1:7891 where you can:

  • Set API keys for OpenRouter, Groq, and Gemini
  • Switch models on-the-fly (changes reflect instantly in the CLI)
  • Browse all 27+ free models and premium paid options

🤖 Supported Free Models (April 2026)

Provider Model Context
OpenRouter Free Models Router (Auto) 200K
OpenAI GPT OSS 120B 131K
OpenAI GPT OSS 20B 131K
Google Gemma 4 31B 262K
Google Gemma 4 26B A4B 262K
Google Gemma 3 27B 131K
Meta Llama 3.3 70B 65K
NVIDIA Nemotron 3 Super 120B 262K
NVIDIA Nemotron 3 Nano 30B 256K
Qwen Qwen3 Coder 480B A35B 262K
Qwen Qwen3 Next 80B A3B 262K
MiniMax MiniMax M2.5 196K
NousResearch Hermes 3 (405B) 131K
...and more See /models in CLI

🛡️ Security Warning

[!CAUTION] QuickVibeAI executes AI-suggested shell commands directly on your machine.

  • Always review commands before confirming execution.
  • Never run as root/administrator.
  • AI models can occasionally suggest destructive commands. Use at your own risk.

⚖️ License

MIT License. See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

quickvibeai-0.1.1.tar.gz (34.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

quickvibeai-0.1.1-py3-none-any.whl (36.4 kB view details)

Uploaded Python 3

File details

Details for the file quickvibeai-0.1.1.tar.gz.

File metadata

  • Download URL: quickvibeai-0.1.1.tar.gz
  • Upload date:
  • Size: 34.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for quickvibeai-0.1.1.tar.gz
Algorithm Hash digest
SHA256 f553a5920e969dd719dc4487f9c59b3b55e96ebe61577bd41a37d99cf23c0454
MD5 6ac51732e537756e80a0e5115745cf83
BLAKE2b-256 72433157d34489cfab955843d617da7b9ac360169a40edf198b37fa7082f3e1d

See more details on using hashes here.

File details

Details for the file quickvibeai-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: quickvibeai-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 36.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for quickvibeai-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f77eddc9dd09fae676070cd0e935a2ea0f447fb8748f31286808529d61ed4044
MD5 603fdc22727ae1bddfa6cb071b91961c
BLAKE2b-256 91f8a3d72f19ab8f18de8759185b38f654d47ff08cbeaaa2468af5f2bbf2a90c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page