https://github.com/vybraan/vyai
vyai – A lightweight CLI tool to interact with the Gemini API from the terminal.
https://github.com/vybraan/vyai
ai cli gemini-ai golang terminal
Last synced: 6 months ago
JSON representation
vyai – A lightweight CLI tool to interact with the Gemini API from the terminal.
- Host: GitHub
- URL: https://github.com/vybraan/vyai
- Owner: vybraan
- Created: 2025-02-11T13:59:47.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-05-18T09:11:38.000Z (about 1 year ago)
- Last Synced: 2025-05-18T10:24:13.520Z (about 1 year ago)
- Topics: ai, cli, gemini-ai, golang, terminal
- Language: Go
- Homepage:
- Size: 7.08 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- charm-in-the-wild - vyai - A lightweight CLI tool to interact with the Gemini API from the terminal. (_built with Bubble Tea, Lip Gloss, Glamour_) (Applications / AI)
README
# vyai
I got tired of using `curl` to make API calls to Gemini just to have an "AI" in my terminal. I wanted something that could also maintain context. The web felt and is bloated, so I built this snazzy CLI tool instead.
## Usage
1. Get a Gemini API key from ai.google.dev.
2. Export the key as an environment variable:
```bash
export GOOGLE_API_KEY=your_api_key_here
```
3. Install the application
### Arch Linux
You can install `vyai` from the AUR using an AUR helper like `yay` or `paru`:
```bash
yay -S vyai
# or
paru -S vyai
```
Else you can install it manually using `git` and `makepkg`:
```bash
git clone https://aur.archlinux.org/vyai.git
cd vyai
makepkg -si
```
### Windows
On Windows you can install it using scoop
```pwsh
# First add the bucket
scoop bucket add vybraan https://github.com/vybraan/bucket
#Then Install it
scoop install vyai
```
### Manually / From Source
1. Clone the repository:
```bash
3. Run the application using:
```bash
make run
```
or
```bash
go run cmd/main.go
```
### Distro specific packages
While not a comprehensive list, [repology](https://repology.org/project/vyai/versions) provides a decent list of distro
specific packages.
[](https://repology.org/project/vyai/versions)
## Keyboard Shortcuts
- Enter → Send message
- Ctrl + C → Close the app
- Tab / Ctrl + Right → Next tab
- Shift + Tab / Ctrl + Left → Previous tab
- ESC → Normal mode
- I → Insert mode
- Ctrl + N → New Chat
- Ctrl + E → Edit Chat with default editor (falback to vi)
- / → Search in chats
- j/down → scroll down
- k/up → scroll up
- g/home → scroll to start
- G/end → scroll to end
- ? → Show/Close help
## Demo
