Minimal Textual chat client for OpenRouter
Project description
tx-ai
Minimal terminal chat UI built with Textual, uv, OpenRouter, and the OpenAI Python client.
Requirements
- Python 3.11+
- OpenRouter API key via
OPENROUTER_API_KEYor the startup prompt
Install
From this checkout:
python -m pip install .
Or with uv:
uv sync
Run With An Env Key
uv run --env-file .env tx-ai
If installed with pip:
OPENROUTER_API_KEY=your_key_here tx-ai
Run Without An Env Key
tx-ai
If OPENROUTER_API_KEY is not set, the app asks for your OpenRouter API key in the input box. That key is used for the current session only and is not saved.
Build A Wheel
uv build
python -m pip install dist/tx_ai-0.1.0-py3-none-any.whl
Publish
uv build
uv publish --token YOUR_PYPI_TOKEN
Notes
- Model is currently hardcoded to
deepseek/deepseek-v4-flash. - The app keeps the conversation in memory for the current session only.
- If no API key is set, the app prompts for one at startup.
- Assistant replies and model thinking are rendered as Markdown.
- Runtime logs are written to
logs/tx-ai.log.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tx_ai-0.1.0.tar.gz.
File metadata
- Download URL: tx_ai-0.1.0.tar.gz
- Upload date:
- Size: 4.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1519ff9767d95336c9b99bcab57ca5a4863db402d92d772da77a5a57d8eb9fda
|
|
| MD5 |
5bbd08c8ebe01086e473544de19b3255
|
|
| BLAKE2b-256 |
9122b26b32ce32f723ae7512cb683fdd241901234947d11e0a294b64e22f87ef
|
File details
Details for the file tx_ai-0.1.0-py3-none-any.whl.
File metadata
- Download URL: tx_ai-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
68e65d6a028715664e69d6e0419917ec4a5399fd0e8d1aaff4491c92b7a4e40e
|
|
| MD5 |
231eb90a87accc4eeff8a758fa4443d8
|
|
| BLAKE2b-256 |
0c115ceabd6ec9a9c85714def2eef8990ebeeb50307f4a6a1ff87af745af62ba
|
