63 lines
1.4 KiB
Markdown
63 lines
1.4 KiB
Markdown
# oAI Chat App
|
|
|
|
A command-line interface for chatting with AI models via OpenRouter, supporting model selection, streaming responses, file attachments, credit tracking, and configurable settings.
|
|
|
|
## Features
|
|
|
|
- Select and switch between OpenRouter models
|
|
- Streaming or buffered responses
|
|
- Attach images and text files to messages
|
|
- View credit usage and balance
|
|
- Set persistent default model
|
|
- Keyboard shortcuts and history
|
|
|
|
## Installation
|
|
|
|
Requires Python 3.8+. Download the repository. Install dependencies:
|
|
|
|
```bash
|
|
pip install typer rich openrouter pyperclip requests prompt_toolkit
|
|
```
|
|
|
|
Or use :
|
|
|
|
```bash
|
|
pip install -r requiremnets.txt
|
|
```
|
|
|
|
For convience you can move the application to a folder in you `$PATH` and rename it to just `oai` .
|
|
|
|
## Usage
|
|
|
|
Run the app and interact via commands:
|
|
|
|
```bash
|
|
python oai_chat.py
|
|
```
|
|
|
|
Example session:
|
|
|
|
```
|
|
Welcome to oAI!
|
|
You> /model gpt
|
|
(Shows table of GPT models)
|
|
Enter model number: 1
|
|
Selected: GPT-4o (openai/gpt-4o)
|
|
|
|
You> Hello, how are you?
|
|
Streaming response... (Press Ctrl+C to cancel)
|
|
Hello! I'm doing great...
|
|
```
|
|
|
|
For full commands, use `/help` in the app.
|
|
|
|
## Screenshot
|
|
|
|
[<img src="https://gitlab.pm/rune/oai/raw/branch/main/images/screenshot_01.png">](https://gitlab.pm/rune/oai/src/branch/main/README.md)
|
|
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License - see the [MIT License](https://opensource.org/licenses/MIT).
|
|
|
|
Author: Rune Olsen |