👁️ Perspt: Your Terminal’s Window to the AI World 🤖

"The keyboard hums, the screen aglow,
AI's wisdom, a steady flow.
Will robots take over, it's quite the fright,
Or just provide insights, day and night?
We ponder and chat, with code as our guide,
Is AI our helper or our human pride?"

Perspt (pronounced “perspect,” short for Personal Spectrum Pertaining Thoughts) is a high-performance command-line interface (CLI) application that gives you a peek into the mind of Large Language Models (LLMs). Built with Rust for maximum speed and reliability, it allows you to chat with the latest AI models from multiple providers directly in your terminal using a modern, unified interface powered by the cutting-edge genai crate.

🚀 Quick Start

Get up and running with Perspt in minutes. Install, configure, and start chatting with AI models.

Getting Started
📚 User Guide

Complete guide to using Perspt effectively, from basic chat to advanced features.

User Guide
🛠 Developer Guide

Deep dive into Perspt’s architecture, contribute to the project, and extend functionality.

Developer Guide
📖 API Reference

Comprehensive API documentation generated from source code comments.

API Reference

✨ Key Features

🤖

Zero-Config Startup: Automatic provider detection from environment variables - just set your API key and run perspt!

🎨

Interactive Chat Interface: A colorful and responsive chat interface powered by Ratatui

⚡

Streaming Responses: Real-time streaming of LLM responses for an interactive experience

🔀

Multiple Provider Support: Seamlessly switch between OpenAI, Anthropic, Google, Groq, Cohere, XAI, DeepSeek, and Ollama

🚀

Dynamic Model Discovery: Automatically discovers available models without manual updates

⚙️

Configurable: Flexible configuration via JSON files or command-line arguments

🔄

Input Queuing: Type new questions while AI is responding - inputs are queued and processed sequentially

📜

Markdown Rendering: Beautiful markdown support directly in the terminal

🛡️

Graceful Error Handling: Robust handling of network issues, API errors, and edge cases

🎯 Supported AI Providers

  • GPT-4.1 - Latest and most advanced model

  • GPT-4o series - GPT-4o, GPT-4o-mini for fast responses

  • o1 reasoning models - o1-preview, o1-mini, o3-mini

  • GPT-4 series - GPT-4-turbo, GPT-4 for complex tasks

  • Latest model variants automatically supported

Note

Perspt leverages the powerful genai crate for unified LLM access, ensuring automatic support for new models and providers with cutting-edge features like reasoning model support.

📋 Perspt

Getting Started

User Guide

Developer Guide

API Reference

Appendices

Download as PDF

Indices and Tables