Skip to main content

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 (img or image command)
  • Image understanding (vision or vis command)
  • Command history (Up/Down arrows)
  • Command auto-completion (Tab key)
  • Customizable configuration via config.json and aisha_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 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 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


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.0.0.tar.gz (17.6 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.0.0-py3-none-any.whl (16.4 kB view details)

Uploaded Python 3

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

Hashes for ash_cli-2.0.0.tar.gz
Algorithm Hash digest
SHA256 bcdc33ac5a428c0501cf6ecb4412de67156064eb78a1ec1a825843e381db51ee
MD5 98fd9a1b36a09a2b1cf5cac12c93753d
BLAKE2b-256 1200379d792ef2f25ee356b701090f6dc2873e48131e18add9cfae56821f7820

See more details on using hashes here.

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

Hashes for ash_cli-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f9fb27baca21d9e270db9e5520c26c5f35c95f2d4bdbb2c9ae600c38f387cc9a
MD5 383783e1a0ae7ccfa8ce7cc36e857e6b
BLAKE2b-256 4d458c31135e857c1b172cdbea3416778c8aa60201cf2511c3bf9ac5b1cb9d84

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