Metadata-Version: 2.1
Name: termax
Version: 0.1.1
Summary: Boost your terminal's intelligence with LLM: intuitive command assistance, seamless customization, and predictive next steps at your fingertips.
Home-page: https://github.com/huangyz0918/termax
Download-URL: https://github.com/huangyz0918/termax/archive/refs/heads/main.zip
Author: Yizheng Huang
Author-email: huangyz0918@gmail.com
Keywords: LLM,deep learning,MLOps,shell,neural networks,command line,terminal,autocomplete
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich ~=13.7.1
Requires-Dist: click ~=8.1.7
Requires-Dist: openai
Requires-Dist: inquirer ~=3.2.4
Requires-Dist: chromadb ~=0.4.24
Requires-Dist: psutil ~=5.9.8
Requires-Dist: instructor ~=0.6.8
Requires-Dist: pydantic ~=2.6.4
Requires-Dist: setuptools ~=68.2.2

# Termax

![](https://github.com/huangyz0918/termax/actions/workflows/lint.yml/badge.svg) ![](https://github.com/huangyz0918/termax/actions/workflows/test.yml/badge.svg) ![PyPI - Version](https://img.shields.io/pypi/v/termax)
![PyPI - Downloads](https://img.shields.io/pypi/dm/termax) ![GitHub License](https://img.shields.io/github/license/huangyz0918/termax)

Termax is an LLM agent in your terminal that converts natural language to commands.

<br/>
<p align="center"> <img src="docs/icon_text.svg" alt="..." width=300>

It is featured by:

- 🍼 Personalized Experience: Optimize the command generation with RAG.
- 📐 Supports various LLMs: OpenAI GPT, Anthropic Claude, Google Gemini, Mistral AI, Baidu Qianfan, and more.
- 🧩 Shell Extensions: Plugin with popular shells like `zsh`, `bash` and `fish`.

## Installation

```bash
pip install termax
```

## Quick Start

After installation, you'll need to configure the LLM (e.g., set the OpenAI API key). A setup guide will automatically launch the first time you use
Termax. Alternatively, you can manually initiate configuration at any time by running `t config` or `termax config`.

#### Ask Commands

You can start using Termax by asking using command `t` or `termax`, for example:

```bash
t show me the top-5 CPU processes
```

Here is a more complex example:

![](docs/ask_cmd.gif)

#### Guess Commands (experimental)

Termax can predict your next move based on your command history—just try t guess or termax guess to generate a suggested
command. It's not only smart, it's fun!

```bash
t guess
```

## Shell Plugin

We support various shells like `bash`, `zsh` and `fish`. You can choose to install the plugins by:

```bash
t install -n <plugin>
```

The `<plugin>` can be any of `zsh`, `bash`, or `fish`. With this plugin, you can directly convert natural language into
commands using the Ctrl + K shortcut.

![](docs/plugin.gif)

You can also easily uninstall the plugin by:

```bash
t uninstall -n <plugin>
```

Remember to source your shell or restart it after installing or uninstalling plugins to apply changes.

## Contributing

For developers, you can install from source code to enable the latest features and bug fixes.

```bash:
cd <root of this project>
pip install -e .
```

We are using [PEP8](https://peps.python.org/pep-0008/) as our coding standard, please read and follow it in case there
are CI errors.

## License

Licensed under the [Apache License, Version 2.0](LICENSE).





