Aisha CLI (ash-cli) v2.1
Aisha CLI is an interactive AI chat assistant designed for your command line. It offers personalized conversations, remembers information, and provides a smooth, customizable, and flicker-free user 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
- Command history (Up/Down arrows)
- Command auto-completion (Tab key)
- Flicker-free display for long responses, ensuring a smooth reading experience.
- Customizable configuration via
config.jsonandaisha_custom_settings.json
Installation
You can install Aisha CLI using pip:
pip install ash-cli
Upgrading from a Previous Version
If you have an older version of ash-cli installed, you can upgrade to the latest version with:
pip install --upgrade 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 groxunding.search off/soff: Disable web search grounding.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.
Metadata
Release files for ash-cli 2.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ash_cli-2.1.0.tar.gz | 16.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ash_cli-2.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 31.5 kB
Release files / ash_cli-2.1.0.tar.gz
| Download URL | ash_cli-2.1.0.tar.gz |
|---|---|
| Size | 16.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
931d27a23e7c90f8f7524c3cc315e569f249fad02c4700324bedd8edfec1835e
|
|
BLAKE2b-256 checksum How to use checksums |
a2817e09d5fbcf7736c6ff3614ee1b072e0208ee48016f9bba774c1b1ffa8423
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.2
|
Release files / ash_cli-2.1.0-py3-none-any.whl
| Download URL | ash_cli-2.1.0-py3-none-any.whl |
|---|---|
| Size | 15.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c37dcc81223c45949d74c7eff14da870ddb0389663fed79c56320e362e77ee0a
|
|
BLAKE2b-256 checksum How to use checksums |
cb1a451c2f5cd5d6d71d38754adcdc2a425b6a9e583ab8cad6d0c62b69729949
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.2
|