Skip to main content

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.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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ash_cli-2.1.0.tar.gz (16.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ash_cli-2.1.0-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

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

Hashes for ash_cli-2.1.0.tar.gz
Algorithm Hash digest
SHA256 931d27a23e7c90f8f7524c3cc315e569f249fad02c4700324bedd8edfec1835e
MD5 d54f45c9ef5b66e56746c366348e5320
BLAKE2b-256 a2817e09d5fbcf7736c6ff3614ee1b072e0208ee48016f9bba774c1b1ffa8423

See more details on using hashes here.

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

Hashes for ash_cli-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c37dcc81223c45949d74c7eff14da870ddb0389663fed79c56320e362e77ee0a
MD5 651b967f539ee6cf17033b32cebea744
BLAKE2b-256 cb1a451c2f5cd5d6d71d38754adcdc2a425b6a9e583ab8cad6d0c62b69729949

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page