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 female elf 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 Q8_0 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, untested)

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.

Credits & Tools

  • Author/Maintainer/Creative Director: Tsoxer — tsoxercontact@gmail.com
  • Code scaffolding & helper scripts: co-authored with ChatGPT
  • Image assets: generated with ChatGPT (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 Q8_0 (TheBloke) — GGUF conversions hosted on Hugging Face; follow the original/model repo licenses. Note: Q8_0 is a very large, high-quality variant and requires significant VRAM.

Third-Party Notices (bundled)

  • 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/

  • intro.wav — generated with AudioLDM 2. Used under CC BY-NC-SA 4.0 for non-commercial, research/educational purposes only.

  • Other AI-generated audio (button presses, UI/game SFX, music, etc.) — generated with TangoFlux. These clips were created using a model whose checkpoints are licensed for non-commercial research use only, subject to the Stability AI Community License (Stable Audio Open) and WavCaps’ academic-use terms. They are included here only for non-commercial, research/educational use.

This package is © 2025-2026 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.8.tar.gz (7.9 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.8-py3-none-any.whl (8.0 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nulla-0.0.8.tar.gz
  • Upload date:
  • Size: 7.9 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.8.tar.gz
Algorithm Hash digest
SHA256 2ae12f718d8d6f6517732feaad42f0db85673862770189dcf3e31a99727d6493
MD5 f222430e9869a5f19a5860c4264eeb4b
BLAKE2b-256 a67a20f3f0226356b20013cd62b2ac241ce790bce9c8a3c6ac691b54c7722eda

See more details on using hashes here.

File details

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

File metadata

  • Download URL: nulla-0.0.8-py3-none-any.whl
  • Upload date:
  • Size: 8.0 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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 d3bf2c496ea8752a0d4ee57b7453f812ae9b9f36f604b74993e2bd2a08c57184
MD5 efe310cfab25582661d9221044363fd9
BLAKE2b-256 93342ebcc510da576711a73aa6a7247718cfc3415909b1bc3b9c6ad36a18c279

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