Simplechat is a command-line chat application that provides an interactive interface for conversing with AI models. It features memory persistence, context awareness, and support for multiple AI providers.

Features

Support for multiple AI providers (OpenAI, Anthropic, XAI, Ollama)
Persistent conversation memory and context
Entity and topic tracking
User identity management
Rich markdown rendering
Command completion
Clipboard integration

Installation

Requires Python 3.11 or higher.

$ pip install simplemind-chat

Usage

Start a chat session:

$ simplechat [--provider=<provider>] [--model=<model>]

API keys should be set in environment variables before running:

$ export OPENAI_API_KEY="..."
$ export ANTHROPIC_API_KEY="..."
$ export XAI_API_KEY="..."
$ export OLLAMA_API_KEY="..."

Options:

--provider: LLM provider to use (openai/anthropic/xai/ollama)
--model: Specific model to use (e.g. o1-preview)

Available Commands

/copy - Copy last assistant response to clipboard
/paste - Paste clipboard content into chat
/help - Show available commands
/exit - Exit the chat session
/clear - Clear the screen
/invoke - Invoke a specific persona
/memories - Display conversation memories

Features in Detail

Memory System

Simplechat includes a sophisticated memory system that:

Tracks conversation topics and entities
Maintains user identity across sessions
Records user preferences and characteristics
Provides context awareness for more coherent conversations

Database

Uses SQLite for persistent storage of:

Conversation entities
User identity
Essence markers (user characteristics and preferences)
Memory markers

Rich Interface

Markdown rendering for formatted output
Command completion
Status indicators
Error handling with retries

Development

The project structure follows a modular design:

cli.py: Command-line interface and main chat loop
db.py: Database operations and schema
plugin.py: Plugin system for memory and context management
settings.py: Configuration and path management

License

MIT License

Contributing

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