Aisha CLI: An interactive AI chat assistant with customizable features.
Project description
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.
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.1.0.tar.gz.
File metadata
- Download URL: ash_cli-2.1.0.tar.gz
- Upload date:
- Size: 16.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
931d27a23e7c90f8f7524c3cc315e569f249fad02c4700324bedd8edfec1835e
|
|
| MD5 |
d54f45c9ef5b66e56746c366348e5320
|
|
| BLAKE2b-256 |
a2817e09d5fbcf7736c6ff3614ee1b072e0208ee48016f9bba774c1b1ffa8423
|
File details
Details for the file ash_cli-2.1.0-py3-none-any.whl.
File metadata
- Download URL: ash_cli-2.1.0-py3-none-any.whl
- Upload date:
- Size: 15.1 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 |
c37dcc81223c45949d74c7eff14da870ddb0389663fed79c56320e362e77ee0a
|
|
| MD5 |
651b967f539ee6cf17033b32cebea744
|
|
| BLAKE2b-256 |
cb1a451c2f5cd5d6d71d38754adcdc2a425b6a9e583ab8cad6d0c62b69729949
|