Skip to main content

Nulla: a local AI companion bootstrapper (Windows) with voice (Whisper ASR + XTTS v2 TTS), llama.cpp + OpenHermes GGUF, and built-in mini-games.

Project description

Nulla

A local Windows bootstrapper for a talkative AI companion — sets up Whisper (ASR), XTTS v2 (TTS), llama.cpp with OpenHermes GGUF, and ships sample mini-games.


Status

Alpha — functional CLI. nulla setup creates isolated venvs, fetches llama.cpp Windows binaries and the OpenHermes-2.5-Mistral-7B GGUF from official upstreams, and wires in Whisper (CPU) + XTTS v2 (CUDA/CPU).
This package does not redistribute third-party models/binaries; they are downloaded during setup under their respective licenses.

Tested Environment

  • GPU: RTX 5070 Ti 16 GB
  • CPU: Ryzen 5 5600X
  • RAM: 32 GB
  • Storage: ~20 GB free recommended
  • OS: Windows 11
  • Python: 3.11.6 (required)

Requirements

  • Windows 11
  • Python 3.11.6 exactly
  • NVIDIA CUDA (optional; CPU fallbacks exist but are slower)

Python requirement: This project targets Python 3.11.6 exactly.

What this package does not include:

  • No Whisper code/weights, no llama.cpp binaries, no XTTS-v2 models, no GGUF models.
  • Future installation helpers (in a later release) will fetch from official sources only. You must accept each upstream license.

Credits & Tools

  • Author/Maintainer: Tsoxer — tsoxercontact@gmail.com
  • Code scaffolding & helper scripts: co-authored with ChatGPT-5
  • Image assets: generated with ChatGPT-5 (OpenAI)

Third-Party Notices (not bundled)

  • OpenAI Whisper — MIT License. Source: openai/whisper.
  • llama.cpp — MIT-licensed C/C++ inference project.
  • XTTS-v2 (Coqui) — licensed under the Coqui Public Model License (non-commercial). You must review and comply with their terms.
  • OpenHermes-2.5-Mistral-7B-GGUF (TheBloke) — GGUF conversions hosted on Hugging Face; follow the original/model repo licenses.
  • salutations.wav by shadoWisp — used in demos; licensed CC BY 3.0. If you use it, give attribution and link the source: https://freesound.org/s/260931/

This package is © 2025 Tsoxer (MIT). See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nulla-0.0.3.tar.gz (5.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nulla-0.0.3-py3-none-any.whl (5.2 MB view details)

Uploaded Python 3

File details

Details for the file nulla-0.0.3.tar.gz.

File metadata

  • Download URL: nulla-0.0.3.tar.gz
  • Upload date:
  • Size: 5.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.6

File hashes

Hashes for nulla-0.0.3.tar.gz
Algorithm Hash digest
SHA256 c6b4e40cbd8f8072d4076606742008d8fb480a35f57c21f8bee777d6d5b484cf
MD5 4c421d72a39ba66127318f380cc6363e
BLAKE2b-256 a2ad8e344d075607598c8c79a09588e9b3288daf80c1a564bc7886ddb17cc97a

See more details on using hashes here.

File details

Details for the file nulla-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: nulla-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 5.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.6

File hashes

Hashes for nulla-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 40170e13c9a03717bcc071c71665f8fa06e29e81c7a709e59fb916951838ceee
MD5 e69631decd8e1343110804f2f555450a
BLAKE2b-256 18e89f6a97cef7828ebb253a11a3b45d2738c52a902428d3dfe1d02dd622e144

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page