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.
- 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.
- Python Script:
- Download the
Retrochat.py
file. - Install the required dependencies.
- Run the script:
python Retrochat.py
- Download the
- Executable:
- Download the
.exe
file. - Run the executable directly from any location.
- Download the
- /config
- Description: Update or retrieve configuration settings.
- Usage:
/config <key> <value>
- Available Keys:
fontsize
: Set the font size.- Example:
/config fontsize 18
- Example:
baseurl
: Set the base URL for API requests.- Example:
/config baseurl http://new-url.com
- Example:
openaiapikey
: Set the OpenAI API key.- Example:
/config openaiapikey YOUR_API_KEY
- Example:
umc
: Set the color of user messages.- Example:
/config umc #00FF00
- Example:
amc
: Set the color of assistant messages.- Example:
/config amc #FFBF00
- Example:
system_prompt
: Set a custom system prompt.- Example:
/config system_prompt "Your prompt here"
- Example:
- /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
- Example:
save <filename>
: Save the current chat history to a specified file.- Example:
/chat save my_chat_backup.json
- Example:
delete <filename>
: Permanently delete a specified chat file.- Example:
/chat delete old_chat.json
- Example:
reset
: Clear the current chat history.- Example:
/chat reset
- Example:
rename <old_filename> <new_filename>
: Rename a chat file.- Example:
/chat rename chat_1.json new_chat_name.json
- Example:
open <filename>
: Open and load an existing chat file.- Example:
/chat open my_chat.json
- Example:
list
: List all JSON chat files in the current directory.- Example:
/chat list
- Example:
-
/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
- Description: Switch between available modes (
-
/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"
- 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.
- The chatbox can be resized by clicking and dragging near the edges of the app at the bottom right corner.
Contributions are welcome! Feel free to fork the project, make changes, and submit a pull request.