A modern terminal interface for your AI assistant, bringing intelligence to your command line.
Fully Local Mode Coming Soon
Installation
Get Yappus running on your system
For other systems or manual builds, check the GitHub repository.
Documentation
Learn how to use Yappus Terminal effectively
Command Line Arguments
Use Yappus directly from your shell for quick tasks.
Interactive Mode Commands
Commands available within the Yappus interactive session (start with `yappus`):
Usage Examples
See Yappus in action with these common use cases.
Available Models
Yappus supports various Gemini models. You can switch between them usingyappus model [MODEL_NAME] or/model [MODEL_NAME].
GEMINI_FLASHCurrent
Default model, latest and greatest from Gemini 2.0 series.
GEMINI_2_5_PRO
Most capable model for complex tasks and reasoning.
GEMINI_2_5_FLASH
High performance with excellent reasoning capabilities.
GEMINI_1_5_PRO
Powerful legacy model, good for general purpose tasks.
GEMINI_1_5_FLASH
Fast and efficient legacy model.
Chat History Management
Keep track of your conversations and manage your data with ease.
Persistent Chat History
Yappus automatically saves your conversations, allowing you to pick up where you left off. History is stored locally in `~/.config/yappus-term/chat_history.json`.
Export Your Chats
Easily export your entire chat history to a JSON file for backup or analysis using the `yappus export [path]` command or `/export [path]` in interactive mode.
Manage History
View your history with `yappus history` or `/history`, and clear it completely with `yappus clear-history` or `/clearhistory` if needed.
Context Awareness
Yappus understands the context of your work for smarter interactions.
Conversation Flow
Yappus remembers previous parts of your current conversation, allowing for natural follow-up questions and more relevant AI responses without needing to repeat context.
File Content Integration
Use the `/file <path>` command to load a file's content directly into the conversation context. The AI can then answer questions or perform tasks based on that specific file.
Directory & Git Awareness
Yappus automatically includes information about your current working directory and (if applicable) your current Git branch and repository status as part of the context provided to the AI.
Features
Powerful capabilities at your fingertips
Interactive CLI
Chat with Gemini AI directly in your terminal.
Multiple Models
Supports various Gemini models, including Gemini 2.0 Flash.
Persistent History
Chat history is saved across sessions.
File Integration
Use /file for context-aware discussions about your code.
Context Awareness
Maintains conversation flow and uses directory/git context.
Command Piping
Combine shell commands with AI queries for powerful workflows.
Configurable
Manage API keys and model preferences easily.
Local Mode (Soon)
Upcoming support for fully local AI via Ollama.