Skip to main content

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.json and aisha_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 the set and reset settings commands.

Getting Started

  1. Install: pip install ash-cli
  2. Run: ash
  3. API Key: On first run, you will be prompted to enter your Google Gemini API key. You can get one from Google AI Studio.
  4. Personalize: Follow the prompts to set your name and Aisha's name. You can change these later with set name <your_name> and set 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)

Source distribution for ash-cli 2.1.0
File Size Uploaded
ash_cli-2.1.0.tar.gz 16.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ash-cli 2.1.0
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

2.1.0 This release

2 release files

2.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page