Basilisk Windows Coding & Data Assistant

Basilisk is a Windows-first desktop AI workspace focused on Python, software development, debugging, and practical data analysis.

Highlights

• Native Windows desktop GUI built with PyQt6.
• Open folders and ZIP project archives.
• Browse and edit source/text files with atomic saves.
• Python syntax checking and explicit-confirmation script execution.
• CSV, TSV, JSON, JSONL, XLSX and XLS analysis with pandas.
• Dataset preview, schema, missing values, duplicates, memory usage and descriptive statistics.
• Project and active-file context can be sent to an OpenAI-compatible chat API.
• Local SQLite conversation memory.
• Optional Windows text-to-speech.
• Windows system information.
• No offensive-security or hacking toolkit is included in this package.

Install from PyPI

py -m pip install --upgrade pip
py -m pip install basilisk-windows-assistant
basilisk

On Windows, basilisk is registered as a GUI script so it launches without opening an extra console window. basilisk-cli is also available for environments where a console entry point is preferred.

Development install

py -m venv .venv
.\.venv\Scripts\Activate.ps1
py -m pip install --upgrade pip
py -m pip install -e .[dev]
pytest

Configure the AI provider

Launch Basilisk, open Settings, and configure the API key, model, and OpenAI-compatible base URL. The application does not ship with an API key.

Build PyPI distributions

The supported modern packaging flow is to build both an sdist and a wheel with python -m build, then validate with twine check before publishing.

py -m pip install --upgrade build twine
py -m build
py -m twine check dist/*

Publish through a trusted CI workflow when possible, or use Twine from a secure publishing environment.

Supported Python versions

Python 3.10 through 3.13 are targeted by the package metadata. The code is pure Python, so the wheel is platform-independent; the desktop runtime itself is intended for Windows.

License

MIT. See LICENSE.