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.

Credits & Tools

  • Author/Maintainer/Creative Director: 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.

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 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.7.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.7-py3-none-any.whl (7.9 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nulla-0.0.7.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.7.tar.gz
Algorithm Hash digest
SHA256 0efb426e4f753f9d2dab6a8218b7e9de55a597f14a125f6bc14b1c9fb5b107ca
MD5 938263ba065f1db9d25026453253c40a
BLAKE2b-256 486419d8d727e27f42267ffd86aa097aa60bcff858fb1205785236028c24fb41

See more details on using hashes here.

File details

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

File metadata

  • Download URL: nulla-0.0.7-py3-none-any.whl
  • Upload date:
  • Size: 7.9 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 adc1d310c522a95d05adc09010147f13c30dd90db336a37a245d350a3efea95c
MD5 667ac8c5d669f3ffa58a910c8d50813a
BLAKE2b-256 ddf70eb965f023e93f3fac2fd053a503e05568b6045d6cd7f0f7cd93dfe9c278

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