Metadata-Version: 2.4
Name: ai-ebash
Version: 0.2.19b1
Summary: Console utility for integrating artificial intelligence into a Linux terminal.
Author: Andrey Bochkarev
Author-email: andrey.bch.1976@gmail.com
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: certifi==2025.8.3
Requires-Dist: charset-normalizer==3.4.3
Requires-Dist: idna==3.10
Requires-Dist: markdown-it-py==3.0.0
Requires-Dist: mdurl==0.1.2
Requires-Dist: platformdirs==4.4.0
Requires-Dist: Pygments==2.19.2
Requires-Dist: requests==2.32.5
Requires-Dist: rich==14.1.0
Requires-Dist: urllib3==2.5.0
Requires-Dist: tomli>=1.2.0; python_version < "3.11"
Requires-Dist: tomli-w>=1.0.0
Requires-Dist: dynaconf==3.2.11

# Ai-ebash!

Console utility for integrating artificial intelligence into a Linux terminal. Allows you to ask an AI question and execute the scripts and commands suggested by the AI in the terminal. It will be useful for novice Linux administrators.

The project is in the pre-alpha stage. In case of problems with the installation or operation of the Ai-bash utility, please contact me.

## Features

- Send chat-style prompts to an LLM (configurable model and endpoint).
- Parse Markdown responses and highlight/number fenced `code` blocks.
- Interactive selection and (optional) execution of code blocks.
- Rich console output via `rich`.
- Configurable via `config.yaml`.

## Requirements

- Python 3.11+

## Installation

### PyPi (pipx) Package (Debian/Ubuntu)

1. Install pipx (if not already installed):
```bash
sudo apt update
sudo apt install pipx python3-venv -y
pipx ensurepath
```

2. Restart the terminal or update the PATH:
```bash
source ~/.bashrc
```

3. Install ai-ebash:
```bash
pipx install ai-ebash
```

### DEB Package (Debian/Ubuntu)
1. Download the latest DEB package from [GitHub Releases](https://github.com/Vivatist/ai-ebash/releases)
2. Install the package:
```bash
sudo dpkg -i ai-ebash_*.deb
# If there are dependency issues, run:
sudo apt-get install -f
```

### Windows (experemental)

1. Install Python v3.11+ (if not already installed):

2. Open CMD or PowerShell and install ai-ebash:
```bash
pip install ai-ebash
```
3. Restart Windows

### Example
```bash
ai Hello AI! Write example script.
```
or
```bash
ai -d Hello AI! Write example script.
```
## Uninstall

To completely remove the utility:

### If installed via pipx:
```bash
pipx uninstall ai-ebash
```

### If installed via DEB package:
```bash
sudo apt remove ai-ebash
# Or for complete deletion, including configuration files:
sudo apt purge ai-ebash
```

### If installed via Windows:
```bash
apt uninstall ai-ebash
```

### You can also use dpkg.:
```bash
sudo dpkg -r ai-ebash
# Or for complete deletion, including configuration files:
sudo dpkg -P ai-ebash
```

## Security

Do NOT execute arbitrary code returned by an LLM without review. Executing assistant-provided code has security and safety risks. Recommended mitigations:

## Contributing

1. Localization to any languages
2. Fork the repo and create a feature branch.
3. Add tests for new behavior.
4. Open a PR with a clear description.

## License

MIT

## Contact

andrey.bch.1976@gmail.com. Issues and PRs are welcome. Include logs and reproduction steps

