Retrochat

Overview

Retrochat is a simple and lightweight chatbox application running a single .py that leverages your local llama.cpp, Kobolt.cpp or https://ollama.com server. This app is designed for easy configuration and seamless communication through a classic chat interface.

Please note: Llama.cpp or any sort of inference isn't included with this app, you will need to run your own server.

Features

Local Server Integration: Easily connect to your local llama.cpp server.
Resizable Interface: Adjust the chatbox size by clicking and dragging near the bottom right corner.
Simple Configuration: Modify settings on-the-fly using straightforward commands or by editing the config.json file.

Getting Started

Installation

Python Script:
- Download the Retrochat.py file.
- Install the required dependencies.
- Run the script:
```
python Retrochat.py
```
Executable:
- Download the .exe file.
- Run the executable directly from any location.

Retrochat Command Reference

Available Commands and Arguments

Configuration Commands

/config
- Description: Update or retrieve configuration settings.
- Usage: /config <key> <value>
- Available Keys:
  - fontsize: Set the font size.
    - Example: /config fontsize 18
  - baseurl: Set the base URL for API requests.
    - Example: /config baseurl http://new-url.com
  - openaiapikey: Set the OpenAI API key.
    - Example: /config openaiapikey YOUR_API_KEY
  - umc: Set the color of user messages.
    - Example: /config umc #00FF00
  - amc: Set the color of assistant messages.
    - Example: /config amc #FFBF00
  - system_prompt: Set a custom system prompt.
    - Example: /config system_prompt "Your prompt here"

Chat Management Commands

/chat
- Description: Manage chat sessions.
- Usage: /chat <action> <filename> [new_name]
- Available Actions:
  - new <filename>: Create and switch to a new chat file.
    - Example: /chat new my_chat.json
  - save <filename>: Save the current chat history to a specified file.
    - Example: /chat save my_chat_backup.json
  - delete <filename>: Permanently delete a specified chat file.
    - Example: /chat delete old_chat.json
  - reset: Clear the current chat history.
    - Example: /chat reset
  - rename <old_filename> <new_filename>: Rename a chat file.
    - Example: /chat rename chat_1.json new_chat_name.json
  - open <filename>: Open and load an existing chat file.
    - Example: /chat open my_chat.json
  - list: List all JSON chat files in the current directory.
    - Example: /chat list

Model Management Commands

/models
- Description: List available models from Ollama or OpenAI (depending on the current mode).
- Usage: /models
/selectmodel
- Description: Select a model for the current mode.
- Usage: /selectmodel <model_name>
- Example: /selectmodel gpt-4-turbo
/resetmodel
- Description: Switch between available modes (llama.cpp, ollama, openai).
- Usage: /resetmodel

Utility Commands

/help
- Description: Display help message with available commands and their usage.
- Usage: /help
/system_prompt
- Description: Set a custom system prompt for the chat session.
- Usage: /system_prompt <prompt_message>
- Example: /system_prompt "Your custom prompt message"

Resources

Detailed Commands and Documentation: For a comprehensive list of commands and usage details, visit the Retrochat Wiki.
Join Our Community: Connect with other users and developers on our Discord.

Screenshots

Usage Tips

The chatbox can be resized by clicking and dragging near the edges of the app at the bottom right corner.

Contribution

Contributions are welcome! Feel free to fork the project, make changes, and submit a pull request.

DefamationStation / Retrochat