An intelligent media exploration ecosystem powered by Google Gemini 2.5. Path bridges the gap between high-level web exploration and low-level terminal efficiency.
Tip
New to Path? Join our Discord Server for instant setup support and community tips.
Most AI tools are either purely web-based or strictly CLI. Path provides a unified experience:
- Web App: For visual, browser-based deep dives.
- Harper CLI: A high-performance Rust TUI for developers who live in the terminal.
- Contextual Search: Powered by Gemini 2.5 Flash for lightning-fast, accurate results.
- Media Generation: Integrated Image Generation using Gemini 2.5 Flash Image.
- Harper TUI: Interactive terminal interface built with
ratatuifor maximum speed. - Hybrid Architecture: Flask-based backend with a standalone Rust binary.
- Python 3.8+ | Node.js 16+ | Rust 1.75+
# Clone and enter
git clone https://github.com/bniladridas/path.git
cd path
# Install dependencies
pip install -r requirements.txt
npm install
# Environment Config
cp .env.example .env
# Open .env and add your GEMINI_API_KEY
To run harper tui from any directory, follow these steps:
# Build the optimized binary
cd rust
cargo build --release
# Install to local bin
mkdir -p ~/.local/bin
cp target/release/harper ~/.local/bin/
chmod +x ~/.local/bin/harper
# Sync your API key for global use
echo "GEMINI_API_KEY=$(grep GEMINI_API_KEY ../.env | cut -d '=' -f2)" > ~/.harper.env
Note: Ensure ~/.local/bin is in your $PATH. If not, add export PATH="$HOME/.local/bin:$PATH" to your .zshrc or .bashrc.
| Command | Action |
|---|---|
harper tui |
Open the Interactive Terminal UI |
harper search "..." |
Quick terminal-based search |
harper image --prompt "..." |
Generate imagery directly from CLI |
Run python run.py and navigate to http://localhost:8000.
- Flask 3.1.2: Core web framework.
- Google GenAI SDK: Powering the Gemini 2.5 integration.
- Gunicorn: Production-grade WSGI server.
- Rust: High-performance core logic.
- Ratatui: Advanced terminal UI rendering.
- Crossterm: Cross-platform terminal manipulation.
- Discord: Join the conversation
- Issues: Report a bug or request a feature
- License: CC BY 4.0
