https://github.com/rudrodip/askitty
A simple CLI tool to interact with generative models like llms and image generation apis.
https://github.com/rudrodip/askitty
async-rust cargo dalle3 groq openai replicate rust rust-ai serde-json stable-diffusion termimad tokio
Last synced: 6 months ago
JSON representation
A simple CLI tool to interact with generative models like llms and image generation apis.
- Host: GitHub
- URL: https://github.com/rudrodip/askitty
- Owner: rudrodip
- License: mit
- Created: 2024-05-05T17:48:31.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-12T13:52:54.000Z (11 months ago)
- Last Synced: 2024-12-01T13:49:50.496Z (6 months ago)
- Topics: async-rust, cargo, dalle3, groq, openai, replicate, rust, rust-ai, serde-json, stable-diffusion, termimad, tokio
- Language: Rust
- Homepage: https://askitty.rdsx.dev
- Size: 371 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# askitty
## Description
`askitty` is a simple CLI tool designed to interact with generative models like large language models (LLMs) and image generation APIs. The tool supports various features, including chat history, new chat session commands, global and individual system prompts, and more.
Check out this [demo](https://x.com/rds_agi/status/1793998351782007104) video
## Features
- **LLM API**: Supports any LLM that follows the OpenAI/v1 spec.
- **Image Generation API**: Supports any image generation API that follows the OpenAI/v1 spec.
- **Chat History**: View and manage chat history.
- **Sessions**: Start new sessions, view existing sessions, and delete sessions.
- **System Prompts**: Set and manage global and session-specific prompts.
- **Configuration**: Set and view global configuration.
- **Error Handling**: Robust error handling for a seamless experience.
- **Markdown Preview**: Preview messages in Markdown format.
## Installation
To get started with `askitty`, you can use the following command to download and install the latest release:
```bash
curl -sSL https://askitty.rdsx.dev/install.sh | bash
```
## Usage
Once installed, you can use `askitty` from the command line with the following syntax:
```bash
askitty [FLAG] [MESSAGE]
```
### Flags
- `-h, --help` Display help message
- `-v, --version` Display version
- `-m, --message` Message to send to the model
- `-i, --imagine` Generate image from text
- `-r, --repl` Start a REPL
- `-n, --new` Start a new session
- `-s, --sessions` View all sessions
- `-s ` View a specific session
- `-d ` Delete a specific session
- `-c, --clear` Clear all sessions
- `-p, --prompt` Set global system prompt
- `-p ` Set a specific session prompt
- `-ps, --prompt-show` Show global system prompt
- `-pc, --prompt-clear` Clear global system prompt
- `-pd, --prompt-delete ` Delete a specific session prompt
- `-vc, --view-config` View global configuration
- `-sc, --set-config` Set global configuration
## Examples
### Sending a Message to the Model
```bash
askitty -m "Hello, how are you?"
```
### Generating an Image from Text
```bash
askitty -i "A beautiful sunset over the mountains"
```
### Starting a New Session
```bash
askitty -n
```
### Viewing All Sessions
```bash
askitty -s
```
### Viewing a Specific Session
```bash
askitty -s
```
### Setting a Global System Prompt
```bash
askitty -p "You are a helpful assistant."
```
## Contributing
Contributions are welcome! Please fork the repository and submit a pull request with your changes.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE.md) file for details.