Yappus Terminal

A terminal interface for your AI terminal assistant, warning it YAPS! xD.

Local options coming soon using ollama.

Features

• Interactive command-line interface for chatting with Gemini AI
• Support for multiple Gemini models (1.5 Pro, 1.5 Flash, etc.)
• Persistent chat history saved between sessions
• Command-line arguments for direct queries and configuration
• Interactive commands within the chat interface
• Export chat history to JSON files
• Configuration management for API keys and model selection
• Syntax highlighting for code blocks in responses
• Simple and easy-to-use interface

In Works

• Using history for more context.
• Using current directory and .git for more knowledge.
• Using history to predict next questions and help.

Prerequisites

• Rust and Cargo (latest stable version)
• A Google Gemini API key (obtain from https://aistudio.google.com/app/apikey)

Installation

For Debian/Ubuntu-based systems:

You can install Yappus directly from our APT repository:

# Download the installation script
curl -O https://raw.githubusercontent.com/MostlyKIGuess/Yappus-Term/main/install-yappus.sh

chmod +x install-yappus.sh

# runnn
./install-yappus.sh

For Arch Linux:

Install from the AUR:

yay -S yappus

Or manually using the PKGBUILD:

git clone https://github.com/MostlyKIGuess/Yappus-Term.git
cd Yappus-Term
makepkg -si

Setup

1. Clone the repository:

   git clone https://github.com/yourusername/yappus-term.git
   cd yappus-term

2. Create a .env file by copying the example:

   cp .env.example .env

3. Add your Gemini API key to the .env file:

   GEMINI_API_KEY=your_api_key_here
   

   Alternatively, run the application and it will prompt you for an API key during first-time setup.

Building

Build the application using Cargo:

cargo build --release

The compiled binary will be available at target/release/yappus.

Installing in your Shell

You can install the application in your PATH using Cargo:

cargo install --path .

Running

You can run the application directly using Cargo:

cargo run

Or execute the binary after building:

./target/release/yappus

Or if installed in your PATH:

yappus

Configuration

Yappus stores its configuration and history files in:

• Linux/macOS: ~/.config/yappus-term/
• Windows: %APPDATA%\yappus\yappus-term\config\

The following files are created:

• api_key - Stores your Gemini API key
• config.json - Stores your preferred model configuration
• chat_history.json - Stores your chat history

Usage

Command Line Arguments

# ask a question directly, you can use or not use the double quotes
yappus "How do I find large files in Linux?"

# model change, type just yappus model to see the list
yappus model GEMINI_1_5_PRO_002

# shows chat history
yappus history

#clears  history
yappus clear-history

# run the setup again
yappus setup

# version info
yappus version

# current config display
yappus config

# reset or check the api key
yappus key
yappus key --reset

# if you wanna export your chats
yappus export ~/my_chat_export.json

Interactive Mode

Start interactive mode by running yappus without arguments:

• Type your message at the prompt (>) and press Enter
• The AI will respond with its message
• Type exit to quit the application

Available Interactive Commands:

• /help - Show help message with available commands
• /model [name] - View or change the Gemini model
• /history - View your chat history
• /clearhistory - Clear your chat history
• /setup - Run the setup process again
• /version - Show version information
• /config - Display current configuration
• /key [reset] - Check or reset API key
• /export [path] - Export chat history to file
• /clear - Clear the terminal screen
• exit - Exit the application

Available Models

• GEMINI_1_5_FLASH - Default model, good balance of speed and capability
• GEMINI_1_5_PRO_002 - Most powerful model
• GEMINI_1_5_PRO - Very capable model
• GEMINI_1_5_FLASH_002 - Good performance
• GEMINI_1_5_FLASH_8B - Fastest responses
• GEMINI_1_0_PRO - Original model

APT Building

docker run --rm -v $(pwd):/build -w /build debian:bookworm bash -c "apt-get update && apt-get install -y build-essential debhelper curl pkg-config libssl-dev && curl -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable && export PATH=\$HOME/.cargo/bin:\$PATH && dpkg-buildpackage -us -uc -b -d && cp -v /*.deb /build/"

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.