quickvibeai 0.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 QuickVibeAI Team
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,4 @@
1
+ include README.md
2
+ include LICENSE
3
+ include requirements.txt
4
+ recursive-include quickvibeai *.py
@@ -0,0 +1,159 @@
1
+ Metadata-Version: 2.4
2
+ Name: quickvibeai
3
+ Version: 0.0.1
4
+ Summary: The ultimate AI coding assistant — multi-provider, cross-platform, terminal-native.
5
+ Home-page: https://github.com/devnathani16/QuickVibeAI
6
+ Author: QuickVibeAI
7
+ Author-email: quickvibeai@proton.me
8
+ Project-URL: Bug Tracker, https://github.com/devnathani16/QuickVibeAI/issues
9
+ Project-URL: Source, https://github.com/devnathani16/QuickVibeAI
10
+ Keywords: ai coding assistant openrouter gemini groq terminal cli quickvibeai
11
+ Classifier: Development Status :: 3 - Alpha
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.9
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Software Development :: Code Generators
22
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
+ Classifier: Environment :: Console
24
+ Requires-Python: >=3.9
25
+ Description-Content-Type: text/markdown
26
+ License-File: LICENSE
27
+ Requires-Dist: httpx>=0.27.0
28
+ Requires-Dist: rich>=13.7.0
29
+ Requires-Dist: prompt_toolkit>=3.0.43
30
+ Requires-Dist: click>=8.1.7
31
+ Requires-Dist: pygments>=2.17.0
32
+ Requires-Dist: openai>=1.52.0
33
+ Requires-Dist: fastapi>=0.104.0
34
+ Requires-Dist: uvicorn>=0.23.0
35
+ Requires-Dist: sse-starlette>=2.0.0
36
+ Requires-Dist: pydantic>=2.0.0
37
+ Dynamic: author
38
+ Dynamic: author-email
39
+ Dynamic: classifier
40
+ Dynamic: description
41
+ Dynamic: description-content-type
42
+ Dynamic: home-page
43
+ Dynamic: keywords
44
+ Dynamic: license-file
45
+ Dynamic: project-url
46
+ Dynamic: requires-dist
47
+ Dynamic: requires-python
48
+ Dynamic: summary
49
+
50
+ # ⚡ QuickVibeAI
51
+
52
+ **The Ultimate AI Coding Assistant — Multi-Provider, Cross-Platform, Terminal-Native.**
53
+
54
+ 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.
55
+
56
+ ## 🚀 Features
57
+
58
+ - **27+ Free Models**: Updated free model list from OpenRouter (GPT OSS 120B, Gemma 4, Qwen3 Coder, Nemotron, Llama 3.3, and more).
59
+ - **Multi-Provider Support**: Switch between OpenRouter, Groq, and Native Gemini via a beautiful local control panel.
60
+ - **Cross-Platform**: Works on **Windows**, **Linux**, **macOS**, and **Termux (Android)**.
61
+ - **Project Aware**: Automatically maps your directory tree to provide full context to the AI.
62
+ - **Native File Operations**: Creates, reads, and deletes files directly within your project.
63
+ - **Smart Command Execution**: Runs dev servers, installs dependencies, and manages builds with user confirmation.
64
+ - **Beautiful UI**: Powered by `Rich` and `Prompt-Toolkit` for a premium terminal experience.
65
+
66
+ ## 🛠️ Installation
67
+
68
+ ### From PyPI (Recommended)
69
+
70
+ ```bash
71
+ pip install quickvibeai
72
+ ```
73
+
74
+ ### From Source
75
+
76
+ ```bash
77
+ git clone https://github.com/devnathani16/QuickVibeAI.git
78
+ cd QuickVibeAI
79
+ pip install -e .
80
+ ```
81
+
82
+ ### Termux (Android)
83
+
84
+ ```bash
85
+ pkg install python rust
86
+ pip install quickvibeai
87
+ ```
88
+
89
+ ## ⌨️ Usage
90
+
91
+ Launch QuickVibeAI from any project directory:
92
+
93
+ ```bash
94
+ quickvibeai
95
+ ```
96
+
97
+ ### First-Time Setup
98
+
99
+ ```bash
100
+ quickvibeai --setup
101
+ ```
102
+
103
+ This will guide you through API key configuration and model selection.
104
+
105
+ ### Options
106
+
107
+ | Flag | Description |
108
+ |------|-------------|
109
+ | `--setup` | Run interactive setup (API key + model) |
110
+ | `--dir PATH` | Set project directory |
111
+ | `--version` | Show version |
112
+
113
+ ### Commands Inside QuickVibeAI
114
+
115
+ | Command | Description |
116
+ |---------|-------------|
117
+ | `/tree` | View the full project file structure |
118
+ | `/models` | List all available free models |
119
+ | `/clear` | Clear the local chat history |
120
+ | `exit` | Quit the application |
121
+
122
+ ## 🌐 Web Control Panel
123
+
124
+ When QuickVibeAI starts, it launches a local web panel at `http://127.0.0.1:7891` where you can:
125
+
126
+ - Set API keys for OpenRouter, Groq, and Gemini
127
+ - Switch models on-the-fly (changes reflect instantly in the CLI)
128
+ - Browse all 27+ free models and premium paid options
129
+
130
+ ## 🤖 Supported Free Models (April 2026)
131
+
132
+ | Provider | Model | Context |
133
+ |----------|-------|---------|
134
+ | OpenRouter | Free Models Router (Auto) | 200K |
135
+ | OpenAI | GPT OSS 120B | 131K |
136
+ | OpenAI | GPT OSS 20B | 131K |
137
+ | Google | Gemma 4 31B | 262K |
138
+ | Google | Gemma 4 26B A4B | 262K |
139
+ | Google | Gemma 3 27B | 131K |
140
+ | Meta | Llama 3.3 70B | 65K |
141
+ | NVIDIA | Nemotron 3 Super 120B | 262K |
142
+ | NVIDIA | Nemotron 3 Nano 30B | 256K |
143
+ | Qwen | Qwen3 Coder 480B A35B | 262K |
144
+ | Qwen | Qwen3 Next 80B A3B | 262K |
145
+ | MiniMax | MiniMax M2.5 | 196K |
146
+ | NousResearch | Hermes 3 (405B) | 131K |
147
+ | ...and more | See `/models` in CLI | — |
148
+
149
+ ## 🛡️ Security Warning
150
+
151
+ > [!CAUTION]
152
+ > **QuickVibeAI executes AI-suggested shell commands directly on your machine.**
153
+ > * **Always review commands** before confirming execution.
154
+ > * **Never run as root/administrator.**
155
+ > * AI models can occasionally suggest destructive commands. Use at your own risk.
156
+
157
+ ## ⚖️ License
158
+
159
+ MIT License. See [LICENSE](LICENSE) for details.
@@ -0,0 +1,110 @@
1
+ # ⚡ QuickVibeAI
2
+
3
+ **The Ultimate AI Coding Assistant — Multi-Provider, Cross-Platform, Terminal-Native.**
4
+
5
+ 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.
6
+
7
+ ## 🚀 Features
8
+
9
+ - **27+ Free Models**: Updated free model list from OpenRouter (GPT OSS 120B, Gemma 4, Qwen3 Coder, Nemotron, Llama 3.3, and more).
10
+ - **Multi-Provider Support**: Switch between OpenRouter, Groq, and Native Gemini via a beautiful local control panel.
11
+ - **Cross-Platform**: Works on **Windows**, **Linux**, **macOS**, and **Termux (Android)**.
12
+ - **Project Aware**: Automatically maps your directory tree to provide full context to the AI.
13
+ - **Native File Operations**: Creates, reads, and deletes files directly within your project.
14
+ - **Smart Command Execution**: Runs dev servers, installs dependencies, and manages builds with user confirmation.
15
+ - **Beautiful UI**: Powered by `Rich` and `Prompt-Toolkit` for a premium terminal experience.
16
+
17
+ ## 🛠️ Installation
18
+
19
+ ### From PyPI (Recommended)
20
+
21
+ ```bash
22
+ pip install quickvibeai
23
+ ```
24
+
25
+ ### From Source
26
+
27
+ ```bash
28
+ git clone https://github.com/devnathani16/QuickVibeAI.git
29
+ cd QuickVibeAI
30
+ pip install -e .
31
+ ```
32
+
33
+ ### Termux (Android)
34
+
35
+ ```bash
36
+ pkg install python rust
37
+ pip install quickvibeai
38
+ ```
39
+
40
+ ## ⌨️ Usage
41
+
42
+ Launch QuickVibeAI from any project directory:
43
+
44
+ ```bash
45
+ quickvibeai
46
+ ```
47
+
48
+ ### First-Time Setup
49
+
50
+ ```bash
51
+ quickvibeai --setup
52
+ ```
53
+
54
+ This will guide you through API key configuration and model selection.
55
+
56
+ ### Options
57
+
58
+ | Flag | Description |
59
+ |------|-------------|
60
+ | `--setup` | Run interactive setup (API key + model) |
61
+ | `--dir PATH` | Set project directory |
62
+ | `--version` | Show version |
63
+
64
+ ### Commands Inside QuickVibeAI
65
+
66
+ | Command | Description |
67
+ |---------|-------------|
68
+ | `/tree` | View the full project file structure |
69
+ | `/models` | List all available free models |
70
+ | `/clear` | Clear the local chat history |
71
+ | `exit` | Quit the application |
72
+
73
+ ## 🌐 Web Control Panel
74
+
75
+ When QuickVibeAI starts, it launches a local web panel at `http://127.0.0.1:7891` where you can:
76
+
77
+ - Set API keys for OpenRouter, Groq, and Gemini
78
+ - Switch models on-the-fly (changes reflect instantly in the CLI)
79
+ - Browse all 27+ free models and premium paid options
80
+
81
+ ## 🤖 Supported Free Models (April 2026)
82
+
83
+ | Provider | Model | Context |
84
+ |----------|-------|---------|
85
+ | OpenRouter | Free Models Router (Auto) | 200K |
86
+ | OpenAI | GPT OSS 120B | 131K |
87
+ | OpenAI | GPT OSS 20B | 131K |
88
+ | Google | Gemma 4 31B | 262K |
89
+ | Google | Gemma 4 26B A4B | 262K |
90
+ | Google | Gemma 3 27B | 131K |
91
+ | Meta | Llama 3.3 70B | 65K |
92
+ | NVIDIA | Nemotron 3 Super 120B | 262K |
93
+ | NVIDIA | Nemotron 3 Nano 30B | 256K |
94
+ | Qwen | Qwen3 Coder 480B A35B | 262K |
95
+ | Qwen | Qwen3 Next 80B A3B | 262K |
96
+ | MiniMax | MiniMax M2.5 | 196K |
97
+ | NousResearch | Hermes 3 (405B) | 131K |
98
+ | ...and more | See `/models` in CLI | — |
99
+
100
+ ## 🛡️ Security Warning
101
+
102
+ > [!CAUTION]
103
+ > **QuickVibeAI executes AI-suggested shell commands directly on your machine.**
104
+ > * **Always review commands** before confirming execution.
105
+ > * **Never run as root/administrator.**
106
+ > * AI models can occasionally suggest destructive commands. Use at your own risk.
107
+
108
+ ## ⚖️ License
109
+
110
+ MIT License. See [LICENSE](LICENSE) for details.
@@ -0,0 +1,8 @@
1
+ """
2
+ QuickVibeAI - The Ultimate AI Coding Assistant.
3
+ A powerful CLI-based coding assistant powered by OpenRouter, Groq, and Gemini.
4
+ """
5
+
6
+ __version__ = "0.0.1"
7
+ __author__ = "QuickVibeAI"
8
+ __description__ = "The ultimate AI coding assistant — multi-provider, cross-platform, terminal-native."
@@ -0,0 +1,7 @@
1
+ """
2
+ Allows running quickvibeai as a module: python -m quickvibeai
3
+ """
4
+ from quickvibeai.cli import main_entry
5
+
6
+ if __name__ == "__main__":
7
+ main_entry()