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.9.tar.gz (32.3 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.9-py3-none-any.whl (32.3 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nulla-0.0.9.tar.gz
  • Upload date:
  • Size: 32.3 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.9.tar.gz
Algorithm Hash digest
SHA256 0bb238b895c7268c9d48c38b7c964a98be3388812ad2d29c6bb2f3075f2c2429
MD5 e30a0db308d413dede95426c1dcf6bb7
BLAKE2b-256 95f2142b7eb4c624589b260aad2fcc4da9f1f4102bb93e81e0125c7fe54b9eb7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: nulla-0.0.9-py3-none-any.whl
  • Upload date:
  • Size: 32.3 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.9-py3-none-any.whl
Algorithm Hash digest
SHA256 ca24eef593d98078cbe23cce96b8de601faa245b7dd438449ead338ff5826a76
MD5 2226bbc957b99d3535d4e242b0284bd6
BLAKE2b-256 3c4f545031f03ef8746562a5d246ee45f92df9f9d636e8a3e35b2139eb04bf76

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