Aisha CLI: An interactive AI chat assistant with customizable features.
Project description
Aisha CLI (ash-cli)
Aisha CLI is an interactive AI chat assistant designed for your command line. It offers personalized conversations, remembers information, generates images, and understands images, all while providing a smooth, customizable experience.
Features:
- Personalized conversational AI (Angel/Evil modes)
- Customizable user and bot names
- Dynamic system prompts for AI persona
- Memory management (remember/recall specific facts)
- Web search grounding for factual queries
- Text-to-Image generation (
imgorimagecommand) - Image understanding (
visionorviscommand) - Command history (Up/Down arrows)
- Command auto-completion (Tab key)
- Customizable configuration via
config.jsonandaisha_custom_settings.json
Installation:
You can install Aisha CLI using pip:
pip install ash-cli
Usage:
After installation, you can run Aisha from any terminal by simply typing ash:
ash
Type help or h for a list of all available commands and their short aliases.
Configuration:
Aisha uses two configuration files, which will be created in your current working directory when you run ash for the first time:
config.json: Contains core settings like API keys and model preferences.aisha_custom_settings.json: Stores your personalized settings such as your name, Aisha's name, and custom AI personas. You can also manage these via thesetandreset settingscommands.
Getting Started:
- Install:
pip install ash-cli - Run:
ash - API Key: On first run, you will be prompted to enter your Google Gemini API key. You can get one from Google AI Studio.
- Personalize: Follow the prompts to set your name and Aisha's name. You can change these later with
set name <your_name>andset botname <new_name>.
Commands:
Aisha supports a variety of commands, many with short aliases:
help/h: Show available commands.exit/quit/bye/x: Exit the chat.clear/c: Clear the console screen.angel: Switch to Angel Mode.evil: Switch to Evil Mode.remember <text>/rem <text>: Store a memory. (e.g.,rem my_name: Raunak)recall <keyword>/rec <keyword>: Find memories.show memory/memory/mem: Display all memories.forget all/fmem: Clear all memories.history/hist: Show chat history.delete history/dh: Clear chat history.search on/son: Enable web search grounding.search off/soff: Disable web search grounding.img <prompt>: Generate an image.vision <path> <question>/vis <path> <question>: Ask about an image.set name <your_name>: Set your display name.set botname <aisha_name>: Set Aisha's display name.set prompt angel <new_prompt>: Customize Angel persona.set prompt evil <new_prompt>: Customize Evil persona.reset settings/rs: Reset custom names/prompts to default.
License:
This project is licensed under the MIT License - see the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ash_cli-2.0.0.tar.gz.
File metadata
- Download URL: ash_cli-2.0.0.tar.gz
- Upload date:
- Size: 17.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bcdc33ac5a428c0501cf6ecb4412de67156064eb78a1ec1a825843e381db51ee
|
|
| MD5 |
98fd9a1b36a09a2b1cf5cac12c93753d
|
|
| BLAKE2b-256 |
1200379d792ef2f25ee356b701090f6dc2873e48131e18add9cfae56821f7820
|
File details
Details for the file ash_cli-2.0.0-py3-none-any.whl.
File metadata
- Download URL: ash_cli-2.0.0-py3-none-any.whl
- Upload date:
- Size: 16.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f9fb27baca21d9e270db9e5520c26c5f35c95f2d4bdbb2c9ae600c38f387cc9a
|
|
| MD5 |
383783e1a0ae7ccfa8ce7cc36e857e6b
|
|
| BLAKE2b-256 |
4d458c31135e857c1b172cdbea3416778c8aa60201cf2511c3bf9ac5b1cb9d84
|