Skip to main content

A chat interface for AI models using Simplemind.

Project description

Simplechat

A chat interface for AI models using Simplemind.

Overview

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simplemind_chat-0.1.8.tar.gz (14.8 kB view details)

Uploaded Source

Built Distribution

simplemind_chat-0.1.8-py3-none-any.whl (15.7 kB view details)

Uploaded Python 3

File details

Details for the file simplemind_chat-0.1.8.tar.gz.

File metadata

  • Download URL: simplemind_chat-0.1.8.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.4.28

File hashes

Hashes for simplemind_chat-0.1.8.tar.gz
Algorithm Hash digest
SHA256 6bf5d8aa186c6713d5590b8f7820f5ebf8d644a4516706359fd6c6ca051eb26d
MD5 ac8dfa4934daa7335e79e1d932e773a5
BLAKE2b-256 96880c7791cd94cb38d664223ccff4568ff984c3da98c991e06e72df67889ac2

See more details on using hashes here.

File details

Details for the file simplemind_chat-0.1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for simplemind_chat-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 f959603084f30171b05370381f9754dbffcb120942dc1195a496729e82001a5a
MD5 4af13078fc2cfe4896257e2a98558c4e
BLAKE2b-256 2579067b62b8298d1458860dac5e6c9cc2f576b9094dcf8ae0b83b7b17a822d4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page