# BrixTerm
## About
**BrixTerm** is a simple terminal app that integrates GPT to assist with everyday development tasks.
---
## Features
- Automatically suggests fixes for failed Unix commands
- Generates Python code and copies it directly to your clipboard
- Built-in chatbot accessible inside the terminal
> **Note:** This tool is **not fully agentic** — developers maintain control by using pre-defined commands.
---
## Available Commands
### 1. TERMINAL (default)
Type any terminal command.
If it fails, the AI will suggest a corrected version.
---
### 2. INTERACTIVE SHELL
Use `!<command>` to run an interactive shell command.
Without the `!`, interactive commands timeout after 10 seconds.
**Example:** `!htop`
---
### 3. CODE GEN
Use `c <your request>` to generate Python code.
The result is automatically copied to your clipboard.
---
### 4. CODE GEN + CLIPBOARD
Use `ccc <your request>` to generate Python code.
The content of your clipboard is passed to the AI as context.
The result is copied back to your clipboard.
---
### 5. ANSWER
Use `a <your request>` to chat with GPT.
---
### 6. EXIT
Use `q` to exit the application.
_____________________________________________________________________
Powered by *LLMBrix* library: https://github.com/matejkvassay/LLMBrix
## Usage guide
### Install
```bash
pip install brix-term
```
### Configure
```bash
# Configure OpenAI API access
export OPENAI_API_KEY='<TOKEN>'
# (optional) GPT model to be used, default is `gpt-4o-mini`
export BRIXTERM_MODEL='gpt-4o'
# (optional) Optimize colors for light mode (dark is default)
export BRIXTERM_COLOR_MODE='light'
# (ALTERNATIVELY) API access for Azure AI is also supported
export AZURE_OPENAI_API_KEY='<TOKEN>'
export AZURE_OPENAI_API_VERSION='<VERSION>'
export AZURE_OPENAI_ENDPOINT='<ENDPOINT>'
```
### Run
```bash
brixterm
```
### Run options
(env vars have priority over these)
```bash
brixterm --help
usage: brixterm [-h] [--dev] [--light_mode] [--model MODEL]
BrixTerm AI Terminal
options:
-h, --help show this help message and exit
--dev (optional) Run in development mode with Arize Phoenix tracing enabled.
--light_mode (optional) Optimize looks for light mode terminal (dark is default).
--model MODEL (optional) Specify GPT model. (default='gpt-4o-mini')
```
Raw data
{
"_id": null,
"home_page": null,
"name": "brix-term",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "LLM, agent, AI, terminal, application, chatbot, llmbrix, llmbricks",
"author": null,
"author_email": "Matej Kvassay <matejkvassay5@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/f4/b6/199505490c477dd5433386fbac279b65d5dd4a2928320752266e01933249/brix_term-0.1.1.tar.gz",
"platform": null,
"description": "# BrixTerm\n\n## About\n\n**BrixTerm** is a simple terminal app that integrates GPT to assist with everyday development tasks.\n\n---\n\n## Features\n\n- Automatically suggests fixes for failed Unix commands\n- Generates Python code and copies it directly to your clipboard\n- Built-in chatbot accessible inside the terminal\n\n> **Note:** This tool is **not fully agentic** \u2014 developers maintain control by using pre-defined commands.\n\n---\n\n## Available Commands\n\n### 1. TERMINAL (default)\n\nType any terminal command.\nIf it fails, the AI will suggest a corrected version.\n\n---\n\n### 2. INTERACTIVE SHELL\n\nUse `!<command>` to run an interactive shell command.\nWithout the `!`, interactive commands timeout after 10 seconds.\n**Example:** `!htop`\n\n---\n\n### 3. CODE GEN\n\nUse `c <your request>` to generate Python code.\nThe result is automatically copied to your clipboard.\n\n---\n\n### 4. CODE GEN + CLIPBOARD\n\nUse `ccc <your request>` to generate Python code.\nThe content of your clipboard is passed to the AI as context.\nThe result is copied back to your clipboard.\n\n---\n\n### 5. ANSWER\n\nUse `a <your request>` to chat with GPT.\n\n---\n\n### 6. EXIT\n\nUse `q` to exit the application.\n_____________________________________________________________________\nPowered by *LLMBrix* library: https://github.com/matejkvassay/LLMBrix\n\n## Usage guide\n\n### Install\n\n```bash\npip install brix-term\n```\n\n### Configure\n\n```bash\n# Configure OpenAI API access\nexport OPENAI_API_KEY='<TOKEN>'\n\n# (optional) GPT model to be used, default is `gpt-4o-mini`\nexport BRIXTERM_MODEL='gpt-4o'\n\n# (optional) Optimize colors for light mode (dark is default)\nexport BRIXTERM_COLOR_MODE='light'\n\n# (ALTERNATIVELY) API access for Azure AI is also supported\nexport AZURE_OPENAI_API_KEY='<TOKEN>'\nexport AZURE_OPENAI_API_VERSION='<VERSION>'\nexport AZURE_OPENAI_ENDPOINT='<ENDPOINT>'\n```\n\n### Run\n\n```bash\nbrixterm\n```\n\n### Run options\n\n(env vars have priority over these)\n\n```bash\nbrixterm --help\nusage: brixterm [-h] [--dev] [--light_mode] [--model MODEL]\n\nBrixTerm AI Terminal\n\noptions:\n -h, --help show this help message and exit\n --dev (optional) Run in development mode with Arize Phoenix tracing enabled.\n --light_mode (optional) Optimize looks for light mode terminal (dark is default).\n --model MODEL (optional) Specify GPT model. (default='gpt-4o-mini')\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "GPT powered terminal for Python developers.",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://github.com/matejkvassay/BrixTerm#readme",
"Homepage": "https://github.com/matejkvassay/BrixTerm",
"Issues": "https://github.com/matejkvassay/BrixTerm/issues",
"Repository": "https://github.com/matejkvassay/BrixTerm"
},
"split_keywords": [
"llm",
" agent",
" ai",
" terminal",
" application",
" chatbot",
" llmbrix",
" llmbricks"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9adf43a8103624a61ce105d616f5b3e081192b7efc3329f95a6b5da3501aacbe",
"md5": "b6c19b76461c92fd1fe78fa06a652a89",
"sha256": "36381434294610df56e360fb7e2531b9304864b7011704f86f25c6f725831d3c"
},
"downloads": -1,
"filename": "brix_term-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b6c19b76461c92fd1fe78fa06a652a89",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 12991,
"upload_time": "2025-07-26T17:25:16",
"upload_time_iso_8601": "2025-07-26T17:25:16.799886Z",
"url": "https://files.pythonhosted.org/packages/9a/df/43a8103624a61ce105d616f5b3e081192b7efc3329f95a6b5da3501aacbe/brix_term-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f4b6199505490c477dd5433386fbac279b65d5dd4a2928320752266e01933249",
"md5": "137e2f57c97dce0c41bfae7906ca6f0c",
"sha256": "c0265906c140868b3efbbb36fe011e2170ebba33dc3bbabb6103b3155b89ae77"
},
"downloads": -1,
"filename": "brix_term-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "137e2f57c97dce0c41bfae7906ca6f0c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 12684,
"upload_time": "2025-07-26T17:25:18",
"upload_time_iso_8601": "2025-07-26T17:25:18.052597Z",
"url": "https://files.pythonhosted.org/packages/f4/b6/199505490c477dd5433386fbac279b65d5dd4a2928320752266e01933249/brix_term-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 17:25:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "matejkvassay",
"github_project": "BrixTerm#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "brix-term"
}
JSON
