Alinux
Alinux is an AI orchestration shell for a minimal Debian 12 desktop running Fluxbox. It converts natural-language requests into a small, validated set of desktop actions.
Install
python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade --no-cache-dir --index-url https://pypi.org/simple 'alinux[openai]'
python -c "import alinux; print(alinux.__version__)"
On a fresh Debian 12 Fluxbox installation, the complete setup is:
python -m pip install alinux
alinux setup
alinux setup installs Tkinter, desktop control tools, Ollama,
starts the Ollama service, and downloads the lightweight smollm2:135m model.
It may ask for your sudo password.
Ollama requires a 64-bit Linux architecture (x86_64 or aarch64). On an
i686/32-bit system, setup installs the desktop portion and skips Ollama;
use GROQ_API_KEY or ALINUX_API_KEY for a remote model, or install Debian
64-bit to use local SmolLM2.
The base package has no compiled model dependency. Use python -m pip install alinux when running without an LLM, or install the openai extra for OpenAI,
Groq, and other OpenAI-compatible providers.
When no API key is configured, Alinux uses Ollama's local JSON-schema API instead of stopping. Install Ollama, start it, and download the lightweight default model:
curl -fsSL https://ollama.com/install.sh | sh
ollama pull smollm2:135m
alinux
Set ALINUX_LOCAL_MODEL to use another model already installed in Ollama.
Alinux includes a small browser built from Python's standard library. It uses
Tkinter, urllib, and html.parser, with no Chromium, Firefox, WebKit, Qt, or
other browser engine. It supports navigation, back/forward, reload, links,
HTML text, and basic HTTP(S) pages. JavaScript, plugins, and advanced CSS are
not supported by this intentionally lightweight engine.
sudo apt install python3-tk
For model access, export a key and optionally choose a provider/model. Any OpenAI-compatible API can be configured with a custom endpoint:
export ALINUX_API_KEY='your-key'
export ALINUX_MODEL='gpt-4o-mini'
export ALINUX_API_BASE_URL='https://your-provider.example/v1'
To use the built-in Groq/Llama configuration from the command line, set your Groq key and pass the flag:
export GROQ_API_KEY='your-groq-key'
alinux --use-default-groq-api
The flag selects llama-3.3-70b-versatile and Groq's API endpoint. It does
not embed or fetch a secret key.
Groq is supported directly, including Alinux's built-in open model preset:
export ALINUX_PROVIDER='groq'
export ALINUX_API_KEY='your-groq-key'
alinux
With ALINUX_PROVIDER=groq and no model override, Alinux uses
llama-3.3-70b-versatile at Groq's OpenAI-compatible endpoint. You can also
select it explicitly with ALINUX_MODEL=llama-3.3-70b-versatile.
The desktop hooks expect xdotool, amixer, free, and uptime. Missing
tools are reported as readable responses rather than terminating Alinux.
Run
alinux
Open the graphical Alinux window from a terminal with:
alinux open
To add Open Alinux to the Fluxbox desktop context menu, run this once inside the Fluxbox session:
alinux install-fluxbox-menu
Remove the menu entry with:
alinux remove-fluxbox-menu
Then restart or reconfigure Fluxbox. The installer uses the active Python
interpreter and writes GUI errors to ~/.cache/alinux/gui.log, so menu
launches continue to work even when Fluxbox has a minimal PATH. It updates
~/.fluxbox/menu without replacing your existing entries. The GUI requires
Debian's python3-tk package and a valid DISPLAY.
Type requests such as show system status, turn the volume down, or
open the terminal. Enter quit or press Ctrl-D to exit.
Alinux never executes arbitrary shell text from the model. Only the operations
listed in its system prompt and system_controls.py are routable.
Metadata
Release files for alinux 0.1.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| alinux-0.1.13.tar.gz | 14.5 kB | Without provenance | Details for alinux-0.1.13.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| alinux-0.1.13-py3-none-any.whl | Python 3 | none | any | Details for alinux-0.1.13-py3-none-any.whl |
Total release size: 31.3 kB
Release files / alinux-0.1.13.tar.gz
| Download URL | alinux-0.1.13.tar.gz |
|---|---|
| Size | 14.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
272ef98c3eee4fab6c6ed5ee292ee288eca433f626528a6181a39ce8acde2622
|
|
BLAKE2b-256 checksum How to use checksums |
059651af87f6a118ae60a1b450a9a0dfbb20c21e615b567fc77abbf1fcd93e5c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.2
|
Release files / alinux-0.1.13-py3-none-any.whl
| Download URL | alinux-0.1.13-py3-none-any.whl |
|---|---|
| Size | 16.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5df013fa03528dc8c1f1ba28a04374cf4e89fa5d5e52c9f4dbd9f501074da454
|
|
BLAKE2b-256 checksum How to use checksums |
04726aaf576558db6b170ad284986675521018aff28d10301f276aca4e0bff9b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.2
|
Security for alinux 0.1.13
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.