aether-ai-agent-cli 1.1.4__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.
- aether_ai_agent_cli-1.1.4/LICENSE +21 -0
- aether_ai_agent_cli-1.1.4/PKG-INFO +309 -0
- aether_ai_agent_cli-1.1.4/README.md +286 -0
- aether_ai_agent_cli-1.1.4/aether_ai_agent_cli.egg-info/PKG-INFO +309 -0
- aether_ai_agent_cli-1.1.4/aether_ai_agent_cli.egg-info/SOURCES.txt +27 -0
- aether_ai_agent_cli-1.1.4/aether_ai_agent_cli.egg-info/dependency_links.txt +1 -0
- aether_ai_agent_cli-1.1.4/aether_ai_agent_cli.egg-info/entry_points.txt +2 -0
- aether_ai_agent_cli-1.1.4/aether_ai_agent_cli.egg-info/top_level.txt +1 -0
- aether_ai_agent_cli-1.1.4/aether_pip/__init__.py +1 -0
- aether_ai_agent_cli-1.1.4/aether_pip/cli.py +49 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/bin/aether.js +10 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/package-lock.json +794 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/package.json +46 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ai/fallback.js +179 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ai/google.js +87 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ai/providers.js +203 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ai/router.js +114 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ai/universal.js +507 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ai/xai.js +50 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/chat.js +1018 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/cli.js +679 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/config.js +214 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/file-parser.js +94 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/modes.js +121 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ui/banner.js +60 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ui/spinner.js +43 -0
- aether_ai_agent_cli-1.1.4/aether_pip/node_project/src/ui/theme.js +169 -0
- aether_ai_agent_cli-1.1.4/setup.cfg +4 -0
- aether_ai_agent_cli-1.1.4/setup.py +62 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Krishiv PB (@Krylo-60)
|
|
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,309 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: aether-ai-agent-cli
|
|
3
|
+
Version: 1.1.4
|
|
4
|
+
Summary: Aether Core AI v110 — Universal AI Gateway CLI (Python Wrapper)
|
|
5
|
+
Home-page: https://github.com/Krylo-60/aether-ai-cli
|
|
6
|
+
Author: Krishiv PB
|
|
7
|
+
Author-email: krylobloxyt@gmail.com
|
|
8
|
+
Classifier: Programming Language :: Python :: 3
|
|
9
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
10
|
+
Classifier: Operating System :: OS Independent
|
|
11
|
+
Requires-Python: >=3.6
|
|
12
|
+
Description-Content-Type: text/markdown
|
|
13
|
+
License-File: LICENSE
|
|
14
|
+
Dynamic: author
|
|
15
|
+
Dynamic: author-email
|
|
16
|
+
Dynamic: classifier
|
|
17
|
+
Dynamic: description
|
|
18
|
+
Dynamic: description-content-type
|
|
19
|
+
Dynamic: home-page
|
|
20
|
+
Dynamic: license-file
|
|
21
|
+
Dynamic: requires-python
|
|
22
|
+
Dynamic: summary
|
|
23
|
+
|
|
24
|
+
# Aether AI CLI
|
|
25
|
+
|
|
26
|
+
> ⚡ **Universal AI Gateway** — 13+ providers, free & paid models, cyberpunk terminal
|
|
27
|
+
|
|
28
|
+
[](https://www.npmjs.com/package/@krishivpb60/aether-ai-cli)
|
|
29
|
+
[](LICENSE)
|
|
30
|
+
[](https://nodejs.org)
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
╔═══════════════════════════════════════════════════════════╗
|
|
34
|
+
║ █████╗ ███████╗████████╗██╗ ██╗███████╗██████╗ ║
|
|
35
|
+
║ ██╔══██╗██╔════╝╚══██╔══╝██║ ██║██╔════╝██╔══██╗ ║
|
|
36
|
+
║ ███████║█████╗ ██║ ████████║█████╗ ██████╔╝ ║
|
|
37
|
+
║ ██╔══██║██╔══╝ ██║ ██╔══██║██╔══╝ ██╔══██╗ ║
|
|
38
|
+
║ ██║ ██║███████╗ ██║ ██║ ██║███████╗██║ ██║ ║
|
|
39
|
+
║ ╚═╝ ╚═╝╚══════╝ ╚═╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ║
|
|
40
|
+
╚═══════════════════════════════════════════════════════════╝
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
**Aether Core AI v110** is a production-ready, globally installable command-line AI assistant that connects to **any AI provider in the world** — both free and paid. Chat with GPT-4o, Claude, Gemini, Llama, Mixtral, DeepSeek, and 50+ more models, all from one terminal.
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## ✨ Features
|
|
48
|
+
|
|
49
|
+
- 🌐 **13+ AI Providers** — OpenAI, Anthropic, Google, Groq, Together, Mistral, OpenRouter, DeepSeek, Cerebras, Cohere, Perplexity, Fireworks, xAI
|
|
50
|
+
- 🆓 **Free Models Included** — Groq, Together AI, Cerebras, OpenRouter, and Cohere all offer generous free tiers
|
|
51
|
+
- 💬 **Interactive Chat** — Full terminal chat with slash commands, mode switching, and file attachments
|
|
52
|
+
- ⚡ **Single-Shot Queries** — Quick one-off questions directly from the CLI
|
|
53
|
+
- 🧠 **4 Reasoning Modes** — Synthesis, Research, Architect, Titan Fusion — each with unique system prompts
|
|
54
|
+
- 📎 **File Context Injection** — Attach code files, logs, or documents for context-aware AI responses
|
|
55
|
+
- 🔄 **Failover Mesh** — Automatic failback across all configured providers
|
|
56
|
+
- 🔢 **Local Math Solver** — Evaluates mathematical expressions without an API call
|
|
57
|
+
- 🤖 **Krylo Companion** — Offline cyberpunk companion bot when no API keys are configured
|
|
58
|
+
- 🔐 **Your Keys, Your Control** — API keys stored locally on YOUR machine, never transmitted anywhere
|
|
59
|
+
- 📤 **Export Conversations** — Save full chat history as Markdown files
|
|
60
|
+
- 🎨 **Cyberpunk UI** — Neon colors, ASCII art, signal bars, and mode badges
|
|
61
|
+
- 🎭 **4 Color Themes** — Cyberpunk, Matrix, Synthwave, Crimson — switch with `/theme`
|
|
62
|
+
- ⌨️ **Custom Commands** — Create reusable prompt shortcuts with `/cmd add`
|
|
63
|
+
- 📝 **File Creation** — AI can create files on your system with path override prompts
|
|
64
|
+
- 📊 **Live Telemetry** — Real-time response latency & tokens/sec in the status bar
|
|
65
|
+
- 🎮 **Mini-Game** — Built-in mainframe hacking game (`/game`)
|
|
66
|
+
- 📋 **Clipboard Copy** — Copy last response to clipboard with `/copy`
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## 🚀 Quick Start
|
|
71
|
+
|
|
72
|
+
### Install globally
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm install -g @krishivpb60/aether-ai-cli
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Or run directly with npx
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
npx @krishivpb60/aether-ai-cli chat
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Setup (Interactive Wizard)
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
aether setup
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
The wizard walks you through configuring providers — **start with free ones!**
|
|
91
|
+
|
|
92
|
+
### Or set keys manually
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# Free providers (recommended to start)
|
|
96
|
+
aether config set GROQ_API_KEY gsk_your_key_here
|
|
97
|
+
aether config set GOOGLE_API_KEY AIza_your_key_here
|
|
98
|
+
aether config set OPENROUTER_API_KEY sk-or-your_key_here
|
|
99
|
+
|
|
100
|
+
# Paid providers
|
|
101
|
+
aether config set OPENAI_API_KEY sk-your_key_here
|
|
102
|
+
aether config set ANTHROPIC_API_KEY sk-ant-your_key_here
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### Start chatting
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
aether chat
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### Quick one-shot query
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
aether ask "Explain quantum computing in simple terms"
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## 📦 Supported Providers
|
|
120
|
+
|
|
121
|
+
| Provider | Key | Free Tier | Default Model |
|
|
122
|
+
|----------|-----|-----------|---------------|
|
|
123
|
+
| **Groq** | `GROQ_API_KEY` | ✅ Generous | `llama-3.3-70b-versatile` |
|
|
124
|
+
| **Together AI** | `TOGETHER_API_KEY` | ✅ Free credits | `Meta-Llama-3.1-70B-Instruct-Turbo` |
|
|
125
|
+
| **Cerebras** | `CEREBRAS_API_KEY` | ✅ Free tier | `llama-3.3-70b` |
|
|
126
|
+
| **OpenRouter** | `OPENROUTER_API_KEY` | ✅ Free models | `llama-3.1-70b-instruct:free` |
|
|
127
|
+
| **Google Gemini** | `GOOGLE_API_KEY` | ✅ Free tier | `gemini-2.5-flash` |
|
|
128
|
+
| **Cohere** | `COHERE_API_KEY` | ✅ Dev free | `command-r-plus` |
|
|
129
|
+
| **Fireworks AI** | `FIREWORKS_API_KEY` | ✅ Free tier | `llama-v3p1-70b-instruct` |
|
|
130
|
+
| **OpenAI** | `OPENAI_API_KEY` | 💳 Paid | `gpt-4o` |
|
|
131
|
+
| **Anthropic** | `ANTHROPIC_API_KEY` | 💳 Paid | `claude-sonnet-4` |
|
|
132
|
+
| **xAI** | `XAI_API_KEY` | 💳 Paid | `grok-2` |
|
|
133
|
+
| **Mistral** | `MISTRAL_API_KEY` | 💳 Paid | `mistral-large-latest` |
|
|
134
|
+
| **DeepSeek** | `DEEPSEEK_API_KEY` | 💳 Paid | `deepseek-chat` |
|
|
135
|
+
| **Perplexity** | `PERPLEXITY_API_KEY` | 💳 Paid | `sonar` |
|
|
136
|
+
|
|
137
|
+
> 💡 **Tip:** Start with **Groq** (fastest, free) or **Google Gemini** (most capable free tier). You can configure multiple providers and Aether will automatically failover between them!
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 🎮 Commands
|
|
142
|
+
|
|
143
|
+
### Core Commands
|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
aether chat # Interactive chat session
|
|
147
|
+
aether ask "your question" # Single-shot query
|
|
148
|
+
aether setup # Guided provider setup wizard
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
### Configuration
|
|
152
|
+
|
|
153
|
+
```bash
|
|
154
|
+
aether config set <KEY> <value> # Set a config value
|
|
155
|
+
aether config get <KEY> # Get a config value
|
|
156
|
+
aether config list # List all config (keys masked)
|
|
157
|
+
aether config delete <KEY> # Delete a config key
|
|
158
|
+
aether config reset # Delete all config
|
|
159
|
+
aether config path # Show config file location
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### Discovery
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
aether providers # List all 13+ supported providers
|
|
166
|
+
aether providers --free # Show only free-tier providers
|
|
167
|
+
aether models # List all available models
|
|
168
|
+
aether models groq # Models for a specific provider
|
|
169
|
+
aether modes # List reasoning modes
|
|
170
|
+
aether status # System status & active providers
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
### Flags
|
|
174
|
+
|
|
175
|
+
```bash
|
|
176
|
+
aether ask "prompt" --mode research # Use specific reasoning mode
|
|
177
|
+
aether ask "prompt" --file error.log # Attach file context
|
|
178
|
+
aether ask "prompt" --model gpt-4o # Override model
|
|
179
|
+
aether ask "prompt" --raw # Raw text output (for piping)
|
|
180
|
+
aether chat --mode architect # Start chat in specific mode
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## 💬 Chat Commands
|
|
186
|
+
|
|
187
|
+
Inside interactive chat mode, use these slash commands:
|
|
188
|
+
|
|
189
|
+
| Command | Description |
|
|
190
|
+
|---------|-------------|
|
|
191
|
+
| `/help` | Show all commands |
|
|
192
|
+
| `/mode <name>` | Switch reasoning mode (synthesis, research, architect, titan) |
|
|
193
|
+
| `/modes` | List all modes with signal bars |
|
|
194
|
+
| `/theme <name>` | Switch visual theme (cyberpunk, matrix, synthwave, crimson) |
|
|
195
|
+
| `/themes` | List available color themes |
|
|
196
|
+
| `/attach <file>` | Attach a file for context (supports Tab autocomplete!) |
|
|
197
|
+
| `/files` | List attached files |
|
|
198
|
+
| `/clear` | Clear terminal screen |
|
|
199
|
+
| `/providers` | Show active providers |
|
|
200
|
+
| `/export` | Export chat to Markdown |
|
|
201
|
+
| `/copy` | Copy last response to clipboard |
|
|
202
|
+
| `/write <file>` | Extract last code block and save to file |
|
|
203
|
+
| `/cmd list` | List custom command shortcuts |
|
|
204
|
+
| `/cmd add <name> <template>` | Create a custom command shortcut |
|
|
205
|
+
| `/cmd remove <name>` | Delete a custom command |
|
|
206
|
+
| `/game` | Start the mainframe hacking mini-game |
|
|
207
|
+
| `/status` | Session status & telemetry |
|
|
208
|
+
| `/history-clear` | Clear saved chat history |
|
|
209
|
+
| `/exit` | End session |
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## 🧠 Reasoning Modes
|
|
214
|
+
|
|
215
|
+
| Mode | Layer | Style | Signal |
|
|
216
|
+
|------|-------|-------|--------|
|
|
217
|
+
| **Synthesis** | v2.5 | Balanced, clean, direct | ████████░░ 80% |
|
|
218
|
+
| **Research** | v104 | Deep analysis, evidence-based | █████████░ 85% |
|
|
219
|
+
| **Architect** | v55 | Systems thinking, debugging | █████████░ 90% |
|
|
220
|
+
| **Titan Fusion** | v110 | Premium, maximum signal density | █████████░ 95% |
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
224
|
+
## 🔐 Security
|
|
225
|
+
|
|
226
|
+
- **Your keys stay on YOUR machine** — stored at `~/.aether/config.json`
|
|
227
|
+
- **No keys are bundled** in the package
|
|
228
|
+
- **No telemetry** — zero data collection
|
|
229
|
+
- **Keys are masked** when displayed (`aether config list`)
|
|
230
|
+
- **Environment variables** also supported as fallback
|
|
231
|
+
|
|
232
|
+
---
|
|
233
|
+
|
|
234
|
+
## 🔄 Failover Mesh
|
|
235
|
+
|
|
236
|
+
Aether routes your prompt through all configured providers automatically:
|
|
237
|
+
|
|
238
|
+
```
|
|
239
|
+
Your Prompt
|
|
240
|
+
↓
|
|
241
|
+
[Provider 1] → Success? → Response ✓
|
|
242
|
+
↓ (fail)
|
|
243
|
+
[Provider 2] → Success? → Response ✓
|
|
244
|
+
↓ (fail)
|
|
245
|
+
[Provider N] → Success? → Response ✓
|
|
246
|
+
↓ (all fail)
|
|
247
|
+
[Krylo Companion] → Local Response ✓
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
If a provider returns an error (rate limit, quota, etc.), Aether automatically tries the next one. Configure multiple free providers for maximum resilience!
|
|
251
|
+
|
|
252
|
+
---
|
|
253
|
+
|
|
254
|
+
## 📁 File Attachment
|
|
255
|
+
|
|
256
|
+
Attach code files, logs, configs, or documents for context-aware responses:
|
|
257
|
+
|
|
258
|
+
```bash
|
|
259
|
+
# From CLI
|
|
260
|
+
aether ask "What's wrong with this code?" --file buggy.js
|
|
261
|
+
|
|
262
|
+
# In chat mode
|
|
263
|
+
/attach error.log
|
|
264
|
+
What errors are in this file?
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
**Supported file types:** `.js`, `.ts`, `.py`, `.html`, `.css`, `.json`, `.md`, `.txt`, `.log`, `.yaml`, `.xml`, `.toml`, `.sql`, `.go`, `.rs`, `.java`, `.c`, `.cpp`, `.rb`, `.php`, `.swift`, `.kt`, `.dart`, `.vue`, `.svelte`, `.sh`, `.bat`, `.ps1`, `.env`, `.csv`
|
|
268
|
+
|
|
269
|
+
---
|
|
270
|
+
|
|
271
|
+
## 🏗️ Development
|
|
272
|
+
|
|
273
|
+
```bash
|
|
274
|
+
# Clone the repo
|
|
275
|
+
git clone https://github.com/Krylo-60/aether-ai-cli.git
|
|
276
|
+
cd aether-ai-cli
|
|
277
|
+
|
|
278
|
+
# Install dependencies
|
|
279
|
+
npm install
|
|
280
|
+
|
|
281
|
+
# Link for local development
|
|
282
|
+
npm link
|
|
283
|
+
|
|
284
|
+
# Test
|
|
285
|
+
aether --help
|
|
286
|
+
aether status
|
|
287
|
+
aether ask "hello"
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
## 📄 License
|
|
293
|
+
|
|
294
|
+
MIT License — see [LICENSE](LICENSE) for details.
|
|
295
|
+
|
|
296
|
+
---
|
|
297
|
+
|
|
298
|
+
## 👨💻 Author
|
|
299
|
+
|
|
300
|
+
**Krishiv PB** ([@Krylo-60](https://github.com/Krylo-60))
|
|
301
|
+
|
|
302
|
+
> *"Stay cyberpunk. ⚡"*
|
|
303
|
+
|
|
304
|
+
---
|
|
305
|
+
|
|
306
|
+
<p align="center">
|
|
307
|
+
<b>⚡ Aether Core AI v110 — Fusion Command Station ⚡</b><br>
|
|
308
|
+
<i>Universal AI Gateway for the Terminal</i>
|
|
309
|
+
</p>
|
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
# Aether AI CLI
|
|
2
|
+
|
|
3
|
+
> ⚡ **Universal AI Gateway** — 13+ providers, free & paid models, cyberpunk terminal
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/@krishivpb60/aether-ai-cli)
|
|
6
|
+
[](LICENSE)
|
|
7
|
+
[](https://nodejs.org)
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
╔═══════════════════════════════════════════════════════════╗
|
|
11
|
+
║ █████╗ ███████╗████████╗██╗ ██╗███████╗██████╗ ║
|
|
12
|
+
║ ██╔══██╗██╔════╝╚══██╔══╝██║ ██║██╔════╝██╔══██╗ ║
|
|
13
|
+
║ ███████║█████╗ ██║ ████████║█████╗ ██████╔╝ ║
|
|
14
|
+
║ ██╔══██║██╔══╝ ██║ ██╔══██║██╔══╝ ██╔══██╗ ║
|
|
15
|
+
║ ██║ ██║███████╗ ██║ ██║ ██║███████╗██║ ██║ ║
|
|
16
|
+
║ ╚═╝ ╚═╝╚══════╝ ╚═╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ║
|
|
17
|
+
╚═══════════════════════════════════════════════════════════╝
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
**Aether Core AI v110** is a production-ready, globally installable command-line AI assistant that connects to **any AI provider in the world** — both free and paid. Chat with GPT-4o, Claude, Gemini, Llama, Mixtral, DeepSeek, and 50+ more models, all from one terminal.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## ✨ Features
|
|
25
|
+
|
|
26
|
+
- 🌐 **13+ AI Providers** — OpenAI, Anthropic, Google, Groq, Together, Mistral, OpenRouter, DeepSeek, Cerebras, Cohere, Perplexity, Fireworks, xAI
|
|
27
|
+
- 🆓 **Free Models Included** — Groq, Together AI, Cerebras, OpenRouter, and Cohere all offer generous free tiers
|
|
28
|
+
- 💬 **Interactive Chat** — Full terminal chat with slash commands, mode switching, and file attachments
|
|
29
|
+
- ⚡ **Single-Shot Queries** — Quick one-off questions directly from the CLI
|
|
30
|
+
- 🧠 **4 Reasoning Modes** — Synthesis, Research, Architect, Titan Fusion — each with unique system prompts
|
|
31
|
+
- 📎 **File Context Injection** — Attach code files, logs, or documents for context-aware AI responses
|
|
32
|
+
- 🔄 **Failover Mesh** — Automatic failback across all configured providers
|
|
33
|
+
- 🔢 **Local Math Solver** — Evaluates mathematical expressions without an API call
|
|
34
|
+
- 🤖 **Krylo Companion** — Offline cyberpunk companion bot when no API keys are configured
|
|
35
|
+
- 🔐 **Your Keys, Your Control** — API keys stored locally on YOUR machine, never transmitted anywhere
|
|
36
|
+
- 📤 **Export Conversations** — Save full chat history as Markdown files
|
|
37
|
+
- 🎨 **Cyberpunk UI** — Neon colors, ASCII art, signal bars, and mode badges
|
|
38
|
+
- 🎭 **4 Color Themes** — Cyberpunk, Matrix, Synthwave, Crimson — switch with `/theme`
|
|
39
|
+
- ⌨️ **Custom Commands** — Create reusable prompt shortcuts with `/cmd add`
|
|
40
|
+
- 📝 **File Creation** — AI can create files on your system with path override prompts
|
|
41
|
+
- 📊 **Live Telemetry** — Real-time response latency & tokens/sec in the status bar
|
|
42
|
+
- 🎮 **Mini-Game** — Built-in mainframe hacking game (`/game`)
|
|
43
|
+
- 📋 **Clipboard Copy** — Copy last response to clipboard with `/copy`
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## 🚀 Quick Start
|
|
48
|
+
|
|
49
|
+
### Install globally
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
npm install -g @krishivpb60/aether-ai-cli
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### Or run directly with npx
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
npx @krishivpb60/aether-ai-cli chat
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Setup (Interactive Wizard)
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
aether setup
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
The wizard walks you through configuring providers — **start with free ones!**
|
|
68
|
+
|
|
69
|
+
### Or set keys manually
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
# Free providers (recommended to start)
|
|
73
|
+
aether config set GROQ_API_KEY gsk_your_key_here
|
|
74
|
+
aether config set GOOGLE_API_KEY AIza_your_key_here
|
|
75
|
+
aether config set OPENROUTER_API_KEY sk-or-your_key_here
|
|
76
|
+
|
|
77
|
+
# Paid providers
|
|
78
|
+
aether config set OPENAI_API_KEY sk-your_key_here
|
|
79
|
+
aether config set ANTHROPIC_API_KEY sk-ant-your_key_here
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Start chatting
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
aether chat
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Quick one-shot query
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
aether ask "Explain quantum computing in simple terms"
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 📦 Supported Providers
|
|
97
|
+
|
|
98
|
+
| Provider | Key | Free Tier | Default Model |
|
|
99
|
+
|----------|-----|-----------|---------------|
|
|
100
|
+
| **Groq** | `GROQ_API_KEY` | ✅ Generous | `llama-3.3-70b-versatile` |
|
|
101
|
+
| **Together AI** | `TOGETHER_API_KEY` | ✅ Free credits | `Meta-Llama-3.1-70B-Instruct-Turbo` |
|
|
102
|
+
| **Cerebras** | `CEREBRAS_API_KEY` | ✅ Free tier | `llama-3.3-70b` |
|
|
103
|
+
| **OpenRouter** | `OPENROUTER_API_KEY` | ✅ Free models | `llama-3.1-70b-instruct:free` |
|
|
104
|
+
| **Google Gemini** | `GOOGLE_API_KEY` | ✅ Free tier | `gemini-2.5-flash` |
|
|
105
|
+
| **Cohere** | `COHERE_API_KEY` | ✅ Dev free | `command-r-plus` |
|
|
106
|
+
| **Fireworks AI** | `FIREWORKS_API_KEY` | ✅ Free tier | `llama-v3p1-70b-instruct` |
|
|
107
|
+
| **OpenAI** | `OPENAI_API_KEY` | 💳 Paid | `gpt-4o` |
|
|
108
|
+
| **Anthropic** | `ANTHROPIC_API_KEY` | 💳 Paid | `claude-sonnet-4` |
|
|
109
|
+
| **xAI** | `XAI_API_KEY` | 💳 Paid | `grok-2` |
|
|
110
|
+
| **Mistral** | `MISTRAL_API_KEY` | 💳 Paid | `mistral-large-latest` |
|
|
111
|
+
| **DeepSeek** | `DEEPSEEK_API_KEY` | 💳 Paid | `deepseek-chat` |
|
|
112
|
+
| **Perplexity** | `PERPLEXITY_API_KEY` | 💳 Paid | `sonar` |
|
|
113
|
+
|
|
114
|
+
> 💡 **Tip:** Start with **Groq** (fastest, free) or **Google Gemini** (most capable free tier). You can configure multiple providers and Aether will automatically failover between them!
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## 🎮 Commands
|
|
119
|
+
|
|
120
|
+
### Core Commands
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
aether chat # Interactive chat session
|
|
124
|
+
aether ask "your question" # Single-shot query
|
|
125
|
+
aether setup # Guided provider setup wizard
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### Configuration
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
aether config set <KEY> <value> # Set a config value
|
|
132
|
+
aether config get <KEY> # Get a config value
|
|
133
|
+
aether config list # List all config (keys masked)
|
|
134
|
+
aether config delete <KEY> # Delete a config key
|
|
135
|
+
aether config reset # Delete all config
|
|
136
|
+
aether config path # Show config file location
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Discovery
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
aether providers # List all 13+ supported providers
|
|
143
|
+
aether providers --free # Show only free-tier providers
|
|
144
|
+
aether models # List all available models
|
|
145
|
+
aether models groq # Models for a specific provider
|
|
146
|
+
aether modes # List reasoning modes
|
|
147
|
+
aether status # System status & active providers
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### Flags
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
aether ask "prompt" --mode research # Use specific reasoning mode
|
|
154
|
+
aether ask "prompt" --file error.log # Attach file context
|
|
155
|
+
aether ask "prompt" --model gpt-4o # Override model
|
|
156
|
+
aether ask "prompt" --raw # Raw text output (for piping)
|
|
157
|
+
aether chat --mode architect # Start chat in specific mode
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
---
|
|
161
|
+
|
|
162
|
+
## 💬 Chat Commands
|
|
163
|
+
|
|
164
|
+
Inside interactive chat mode, use these slash commands:
|
|
165
|
+
|
|
166
|
+
| Command | Description |
|
|
167
|
+
|---------|-------------|
|
|
168
|
+
| `/help` | Show all commands |
|
|
169
|
+
| `/mode <name>` | Switch reasoning mode (synthesis, research, architect, titan) |
|
|
170
|
+
| `/modes` | List all modes with signal bars |
|
|
171
|
+
| `/theme <name>` | Switch visual theme (cyberpunk, matrix, synthwave, crimson) |
|
|
172
|
+
| `/themes` | List available color themes |
|
|
173
|
+
| `/attach <file>` | Attach a file for context (supports Tab autocomplete!) |
|
|
174
|
+
| `/files` | List attached files |
|
|
175
|
+
| `/clear` | Clear terminal screen |
|
|
176
|
+
| `/providers` | Show active providers |
|
|
177
|
+
| `/export` | Export chat to Markdown |
|
|
178
|
+
| `/copy` | Copy last response to clipboard |
|
|
179
|
+
| `/write <file>` | Extract last code block and save to file |
|
|
180
|
+
| `/cmd list` | List custom command shortcuts |
|
|
181
|
+
| `/cmd add <name> <template>` | Create a custom command shortcut |
|
|
182
|
+
| `/cmd remove <name>` | Delete a custom command |
|
|
183
|
+
| `/game` | Start the mainframe hacking mini-game |
|
|
184
|
+
| `/status` | Session status & telemetry |
|
|
185
|
+
| `/history-clear` | Clear saved chat history |
|
|
186
|
+
| `/exit` | End session |
|
|
187
|
+
|
|
188
|
+
---
|
|
189
|
+
|
|
190
|
+
## 🧠 Reasoning Modes
|
|
191
|
+
|
|
192
|
+
| Mode | Layer | Style | Signal |
|
|
193
|
+
|------|-------|-------|--------|
|
|
194
|
+
| **Synthesis** | v2.5 | Balanced, clean, direct | ████████░░ 80% |
|
|
195
|
+
| **Research** | v104 | Deep analysis, evidence-based | █████████░ 85% |
|
|
196
|
+
| **Architect** | v55 | Systems thinking, debugging | █████████░ 90% |
|
|
197
|
+
| **Titan Fusion** | v110 | Premium, maximum signal density | █████████░ 95% |
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## 🔐 Security
|
|
202
|
+
|
|
203
|
+
- **Your keys stay on YOUR machine** — stored at `~/.aether/config.json`
|
|
204
|
+
- **No keys are bundled** in the package
|
|
205
|
+
- **No telemetry** — zero data collection
|
|
206
|
+
- **Keys are masked** when displayed (`aether config list`)
|
|
207
|
+
- **Environment variables** also supported as fallback
|
|
208
|
+
|
|
209
|
+
---
|
|
210
|
+
|
|
211
|
+
## 🔄 Failover Mesh
|
|
212
|
+
|
|
213
|
+
Aether routes your prompt through all configured providers automatically:
|
|
214
|
+
|
|
215
|
+
```
|
|
216
|
+
Your Prompt
|
|
217
|
+
↓
|
|
218
|
+
[Provider 1] → Success? → Response ✓
|
|
219
|
+
↓ (fail)
|
|
220
|
+
[Provider 2] → Success? → Response ✓
|
|
221
|
+
↓ (fail)
|
|
222
|
+
[Provider N] → Success? → Response ✓
|
|
223
|
+
↓ (all fail)
|
|
224
|
+
[Krylo Companion] → Local Response ✓
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
If a provider returns an error (rate limit, quota, etc.), Aether automatically tries the next one. Configure multiple free providers for maximum resilience!
|
|
228
|
+
|
|
229
|
+
---
|
|
230
|
+
|
|
231
|
+
## 📁 File Attachment
|
|
232
|
+
|
|
233
|
+
Attach code files, logs, configs, or documents for context-aware responses:
|
|
234
|
+
|
|
235
|
+
```bash
|
|
236
|
+
# From CLI
|
|
237
|
+
aether ask "What's wrong with this code?" --file buggy.js
|
|
238
|
+
|
|
239
|
+
# In chat mode
|
|
240
|
+
/attach error.log
|
|
241
|
+
What errors are in this file?
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
**Supported file types:** `.js`, `.ts`, `.py`, `.html`, `.css`, `.json`, `.md`, `.txt`, `.log`, `.yaml`, `.xml`, `.toml`, `.sql`, `.go`, `.rs`, `.java`, `.c`, `.cpp`, `.rb`, `.php`, `.swift`, `.kt`, `.dart`, `.vue`, `.svelte`, `.sh`, `.bat`, `.ps1`, `.env`, `.csv`
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
## 🏗️ Development
|
|
249
|
+
|
|
250
|
+
```bash
|
|
251
|
+
# Clone the repo
|
|
252
|
+
git clone https://github.com/Krylo-60/aether-ai-cli.git
|
|
253
|
+
cd aether-ai-cli
|
|
254
|
+
|
|
255
|
+
# Install dependencies
|
|
256
|
+
npm install
|
|
257
|
+
|
|
258
|
+
# Link for local development
|
|
259
|
+
npm link
|
|
260
|
+
|
|
261
|
+
# Test
|
|
262
|
+
aether --help
|
|
263
|
+
aether status
|
|
264
|
+
aether ask "hello"
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
---
|
|
268
|
+
|
|
269
|
+
## 📄 License
|
|
270
|
+
|
|
271
|
+
MIT License — see [LICENSE](LICENSE) for details.
|
|
272
|
+
|
|
273
|
+
---
|
|
274
|
+
|
|
275
|
+
## 👨💻 Author
|
|
276
|
+
|
|
277
|
+
**Krishiv PB** ([@Krylo-60](https://github.com/Krylo-60))
|
|
278
|
+
|
|
279
|
+
> *"Stay cyberpunk. ⚡"*
|
|
280
|
+
|
|
281
|
+
---
|
|
282
|
+
|
|
283
|
+
<p align="center">
|
|
284
|
+
<b>⚡ Aether Core AI v110 — Fusion Command Station ⚡</b><br>
|
|
285
|
+
<i>Universal AI Gateway for the Terminal</i>
|
|
286
|
+
</p>
|