Skip to content

Releases

Kindred Spirit 0.4.0-beta.1

Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 12:58
e872595

Added

  • She tells you how it really went: when a build, blueprint or job ends, the game reports its real result and
    she says it as it is: "All done!" only when it's finished, "most of it went in, 12 wouldn't fit" when it half-failed,
    why she had to stop when something stopped her (no blocks left, pockets full). Starting one, she says she's on it,
    never that it's done (#139).
  • One key stops her (H, changeable in Controls): talking, leading, a build or blueprint halfway and a job stop at
    once, without waiting for her brain; "undo that" then puts back what she had changed (#138).
  • Host her on Windows: scripts\setup-windows.ps1, start-windows.ps1 and stop-windows.ps1 set up and run her
    brain, voice, memory and hearing (whisper.cpp's Windows build, checked by SHA-256) on a Windows PC, like the Mac's
    scripts; her dashboard's sleep and wake buttons use them there. Tested on GitHub's Windows machines on every
    pull request that touches them (docs/HOSTING-WINDOWS.md, #40).
  • Host her with Docker on Windows or Linux: her brain, voice, hearing and dashboard in one image on GitHub
    Packages (ghcr.io/petitpotam/kindred-spirit-brain), run on your own computer with scripts/docker-run.sh or
    scripts\docker-run.ps1; your ~/.kindred-spirit is mounted and the ports stay on 127.0.0.1. Published with every
    release, built and tested on every pull request that touches it (docker/README.md, #128).
  • Village houses and structures for everyone: the game copies its own village buildings (every biome),
    shipwrecks, the pillager watchtower, the igloo and the ruined portals into a blueprint folder of their own when it
    starts, so every player can ask for "a taiga house" or "a shipwreck" on any supported Minecraft version (#181).
  • Her settings in the game: J (or /kindred settings, or Mod Menu's Configure button) opens a screen with the
    same settings and profiles as her dashboard, section by section, each with its explanation and default; changes
    apply at once. In a friend's game (her brain on another computer) it shows the game's own settings (#5).
  • Put her to sleep and wake her up: buttons on her dashboard (and /kindred sleep, /kindred wake in the game)
    stop her brain, voice and hearing and start them again; "Stop everything" stops the dashboard too. While she's
    asleep the game says so, instead of "her brain isn't running" (#187).
  • "Undo that": her newest build or flattening goes back exactly as it was, up to 16 builds back, while the world
    is open; a chest she built that you filled drops its contents, and in grounded style her blocks come back to your
    pockets (#129).
  • The Play shortcut can play any branch on this computer (a batch being worked on, for example); main and pull
    requests are built in a separate play copy, so playing never switches your checkout's branch.
  • The Play shortcut asks which Pip to play: the installed release, the newest code (built and installed first) or a
    pull request; Enter keeps the one in use (#190).
  • scripts/play-latest.sh: playtest main or a pull request straight from the checkout, without a release, and
    go back to the installed version with --back (#185).

Fixed

  • On Minecraft 26.3 she builds blueprints on grass again (she took grass, podzol, moss and mud for something you
    built: 26.x moved them out of the game's dirt tag), and flattening fills under grass with dirt (#181).
  • Structure files saved by Minecraft 26.x (a structure block, /place template) can be built: their palette is
    written a new way (id, properties), which she couldn't read (#181).
  • On Minecraft 26.3 she knows she's in 26.3: her prompt names your version, and her knowledge judges what was added
    later (the Happy Ghast, the Copper Golem) against it when you ask, not against 1.21.1; 1.21.1 game data is
    marked as such for a 26.3 player (#151).
  • The Play shortcut (scripts/play-mac.command) starts the version in use: the installed one, or the checkout after
    scripts/play-latest.sh; it no longer mixes the checkout's brain with the installed mod, and it lists your Kindred
    profiles (#188).
  • On a new Minecraft profile (26.3 from the Setup), she offered blueprints the game couldn't find: the game now tells
    her which blueprint folders it reads, the dashboard's Blueprints page follows the game played last, and the Setup
    brings the blueprints you already have in another Kindred profile (#175).
  • She never says a build is done when it failed: a lookup no longer counts as having done something, and a claim on
    her last try becomes an honest sentence (#176).
  • Her "I'm starting" lines never sound like no: "Leave it to me!" had been rewritten short as "Leave it!"; lines
    like that are dropped, including the one she had already learned (#177).
  • A build with no shape no longer becomes a pillar: a blueprint's name goes to her blueprints, otherwise she asks
    which shape (#178).
  • "Cut them off" (the trees) means chopping them, not pushing monsters away; and "show me what you built" leads you
    to her last build (#179).
  • The dashboard no longer lists "opening handshake failed" over and over: that was the Setup checking her brain is
    up; such a check is logged quietly now, and real handshake problems still show (#180).
  • The README no longer contradicts itself: she only changes your world when you ask, mining and crafting jobs
    work (jobs on LAN don't yet), the manual setup says what it installs, which AI speaks for her, and how the
    dashboard is protected (#173).

Kindred Spirit Setup (macOS)

One download that installs her brain, her AI, her models and the mod, step by step. How to open it the first time (macOS asks, because it isn't signed with a paid Apple certificate): docs/SETUP.md.

  • Apple silicon (M1 and newer): Kindred-Spirit-Setup-0.4.0-beta.1-macos-arm64.dmg (built and tested on GitHub's Apple silicon Mac)
  • Intel: Kindred-Spirit-Setup-0.4.0-beta.1-macos-x86_64.dmg (built and tested on GitHub's Intel Mac; not yet tried by a person on a real Intel Mac: reports welcome)
  • Windows and Linux: not yet (#40, #81). Friends on any system can join a host's LAN world with just the mod.

Check a download: shasum -a 256 -c Kindred-Spirit-Setup-0.4.0-beta.1-macos-arm64.dmg.sha256 (in the folder where both are).

Kindred Spirit 0.3.0-beta.1

Pre-release

Choose a tag to compare

@github-actions github-actions released this 14 Nov 01:43
eefd257

The beta: Pip on the newest Minecraft, and a Mac app that sets her up for you. Her brain runs on the host's Mac;
friends on LAN need only the mod.

New

  • Kindred Spirit Setup for macOS, attached to every release for Apple silicon and Intel Macs: a downloaded app,
    no terminal. It carries its own Python and opens a guide in your browser where each step explains itself,
    recommends a choice, has Test it, and a Copy a help prompt button for any AI assistant (keys, e-mail
    addresses and your user name taken out). The steps: your computer, her brain, her AI, her instincts, voice and
    hearing, Minecraft, saying hi to her, her slow thinking, and waking her when you log in (#82, #93).
    • Her AI: Gemini with a free key by default (with a guided way to get one), another service with your key
      (OpenAI, Groq, Mistral, OpenRouter, Claude API), Ollama on your Mac, or Claude Code, Codex or Gemini CLI; for her
      slow thinking, the same, another one, or off. Each choice is tried with a real call; keys stay in
      ~/.kindred-spirit/secrets.env (#94).
    • Her models, sized for your Mac: instincts (bge-small), voice (Kokoro, with Hear it for each voice) and
      hearing (Whisper, with a microphone test), downloaded with progress, a SHA-256 check and resume. The app brings
      its own whisper-server: no Homebrew needed (#95).
    • Minecraft: a Kindred Spirit launcher profile for 26.3 (recommended) or 1.21.1, with Fabric Loader, Fabric API
      and the matching mod in a game folder of its own, or the mod in another launcher's mods folder; then Say hi to
      her
      checks the whole chain, from the game to her answer (#96).
    • Updates: it checks GitHub Releases, shows what's new, and updates her brain, the mod and the Setup together,
      keeping your settings and memories; Go back returns to the version before (#97).
    • Her dashboard is part of it: once she's set up, opening the Setup wakes her and opens her dashboard; and, if
      you choose, she wakes when you log in (#111).
  • Minecraft 26.3, the newest release, next to 1.21.1: one jar for each, built from the same code and tested for
    every version. The Setup, install_profile.py --minecraft 26.3 and Update Pip (-Minecraft <version>) pick the
    right one (#41).
  • Press K in the game to open her dashboard in your browser, on the computer where her brain runs (change the key
    in Controls → Kindred Spirit). On a friend's computer with only the mod, it says the dashboard is on the host's
    (#107).
  • A Download page on the website with Kindred Spirit Setup for each Mac chip and how to open it the first time;
    every page now matches the beta (26.3 and 1.21.1, the Setup, K, Java 25 for friends) (#146).
  • Installed only the mod? In your own world, one chat message now says that Pip needs her brain on this computer,
    with links to the Setup and to playing with a friend who hosts her, and Don't show again
    (/kindred hint off). Mod Menu's description and links say the same (#92). Its Setup link, and Mod Menu's homepage,
    open the website's Download page (#146).

Fixed

  • /kindred reset also forgets the places she noticed on her own (your bed, builds, where you died), so the new
    companion really starts fresh (#121).
  • Stopping her (scripts/stop.sh, the Setup's Stop, an update's restart) waits until her helpers have really exited,
    so starting again never finds a port still taken.
  • Friends building the mod on Windows need Java 25, not Java 21: the guides say so, and Update Pip checks Java first
    and says what to install (#109).
  • The game tells her brain the mod's real version, not always 0.1.0 (#114).
  • The 1.21.1 jar asks for exactly 1.21.1, not any 1.21.x, which it never ran on.
  • Her dashboard's Settings page finds the game's settings on Minecraft 26.3 (its profile has a game folder of its own)
    and in another launcher's instance chosen in the Setup; with several, those of the game played last (#159).

Good to know

  • Hosting her brain is macOS only for now: Windows (#40) and Linux (#81) are planned. Friends on Windows join a Mac
    host's world with the mod.
  • The app isn't signed by Apple (that needs a paid membership): the first time, macOS warns you, and docs/SETUP.md
    shows how to open it anyway.
  • Tested on GitHub's Apple silicon and Intel Macs with every release, with a stand-in AI. Nobody has tried yet: the
    first-run warning on a real download, a real Intel Mac, Open Minecraft with a real launcher and the
    microphone question, real AI keys through the Setup, and updating from one real release to the next. Reports are
    very welcome.
  • On 26.3, her Minecraft knowledge base still assumes 1.21.1 (what came after it is treated as newer than your
    game) unless you set its version (docs/KNOWLEDGE.md).
  • Recording demo videos works on 1.21.1 only for now.

For contributors

  • Linters: Ruff checks the Python on every pull request (and in scripts/test.sh), and the mod builds with every Java
    warning on, a warning failing the build; the few they found are fixed (#168).
  • The README shows the OpenSSF Best Practices badge; SECURITY.md's private reporting no longer waits for the repository
    to be public; the maintaining guide says when to wait for the Mac checks (#170).
  • Code scanning fixes: cleaning the text for her voice stays quick whatever it's sent, the gateway never passes a
    line break into a header, and the dashboard's "Try Pip" heart panel only shows numbers it computed (#163).
  • Small changes go to main in batches: one pull request for several, each change still with its issue. The
    maintainer always batches; contributors may batch closely related changes (docs/MAINTAINING.md, #166).
  • The workflows pin every action to an exact commit and give each job only the permissions it needs, and releases
    carry signed build provenance for every jar and Setup file (OpenSSF Scorecard, #152).
  • Safe minimum versions for the demo video tool (Pillow 13.0.0) and the tests (pytest 9.0.3), which clears the 56
    known vulnerabilities OpenSSF Scorecard reported; nothing players install was affected (#152).
  • Install checks on every system, on GitHub's clean machines with no AI key: the Setup on Apple silicon and Intel
    Macs, her brain and Minecraft's side on macOS and Linux, a friend's install on Windows, and a real Minecraft client
    on Linux that says hi and hears her answer, for each Minecraft version (#104, #105). scripts/test-install.sh runs
    them locally, and in Docker for Linux (docs/TESTING-PLATFORMS.md).
  • The mod builds with a JDK 25 into one jar per Minecraft version (Stonecutter); the sandbox game is
    ./gradlew :26.3:runClient (or :1.21.1:runClient), in mod/versions/<version>/run/.
  • Releases build and smoke-test the Setup for both Mac chips from the release's own jars and attach it with a SHA-256
    and a note saying what was tested where; they upload each jar to Modrinth and CurseForge for its own Minecraft
    once those projects are live (#98). The Setup gets the release's jars from one flat folder, and a build asked for
    a release's jars stops if they aren't there, rather than making a Setup without the mod (#155).
  • CodeQL and OpenSSF Scorecard check the repository, and docs/MAINTAINING.md explains every check (#124).
  • New issues get their area label automatically, and a bug report missing the computer and the logs gets a friendly
    request for them; GitHub Copilot follows the project's rules and review checklist (#126).
  • Every change, release and website update reaches main through a pull request whose CI passed; a release is a
    "Release X" pull request, then its tag. One convention for branches, titles and issue links (CONTRIBUTING.md),
    checked on every pull request.
  • scripts/release.sh finds the JDK 25 by itself, as scripts/test.sh does, and builds before it changes anything, so
    a failed build never leaves a half-made release branch; --help shows how it's used (#160).
  • The README and guides describe the Setup, 26.3, the K key and what hasn't been tried yet (#145).
  • THIRD_PARTY_NOTICES.md names the AI the player chooses and the libraries inside the Setup's Python, and says
    which commits carry an AI co-author line; docs/SETUP.md lists the steps in the Setup's own order (#157).
  • Filming tools for the demo video (#144): the setting hudWithHiddenGui (off) and the dev-script step
    ownhud on|off keep her own HUD with F1; a recording's start event has the computer's clock (wall), fps and
    size, and a friend's line to her on LAN is recorded with from; -PplayerName= names the dev player and
    -PguestVideoSize= sizes the guest's window; the dashboard reads another game's settings with KINDRED_MOD_CONFIG;
    session logs follow KINDRED_HOME.

Kindred Spirit Setup (macOS)

One download that installs her brain, her AI, her models and the mod, step by step. How to open it the first time (macOS asks, because it isn't signed with a paid Apple certificate): docs/SETUP.md.

  • Apple silicon (M1 and newer): Kindred-Spirit-Setup-0.3.0-beta.1-macos-arm64.dmg (built and tested on GitHub's Apple silicon Mac)
  • Intel: Kindred-Spirit-Setup-0.3.0-beta.1-macos-x86_64.dmg (built and tested on GitHub's Intel Mac; not yet tried by a person on a real Intel Mac: reports welcome)
  • Windows and Linux: not yet (#40, #81). Friends on any system can join a host's LAN world with just the mod.

Check a download: shasum -a 256 -c Kindred-Spirit-Setup-0.3.0-beta.1-macos-arm64.dmg.sha256 (in the folder where both are).

Kindred Spirit 0.2.0-preview

Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Nov 15:30

The first preview of Kindred Spirit. Pip is a little spirit who floats beside you in Minecraft 1.21.1 (Fabric),
talks with you by voice or chat, and helps you play. Her brain runs on the host's computer (macOS for now) with
your own AI key; friends on LAN need only the mod.

What's in it

  • Talking: hold V to speak, or type in chat. Short answers in her own voice, with local voice and hearing. Say
    "shh" and she stops.
  • Her senses: what's in her line of sight, the sounds around you, your health and surroundings. She warns you
    about creepers, lava, big drops and low health.
  • Helping: she finds ores, animals, structures and biomes and leads you there, pushes monsters away, chops and
    mines, crafts from your pockets, brings your things back after you die, and helps with villager trades.
  • Building: shapes at any size (circles, stars, hearts, spheres, domes, towers, pyramids...), crop farms, nether
    and end portals, flattened land, and whole buildings from a catalogue of blueprints. Ask for something while
    she's busy and she'll do it next, with her progress on screen.
  • A heart: a bond that grows with kindness, with moods, sulks, pranks and making up, powers she discovers with
    you, and a first meeting of her own.
  • Memory: your name, what you like, your places (your bed, your builds, where you died), and a diary of your
    sessions.
  • Friends on LAN: one shared Pip on the host's computer, seen and heard by everyone with the mod.
  • Skins and settings: a slime, a cube, a fairy, a sprout, a wisp, a starry orb, or your own PNG; how much she
    may do, and how chatty she is.

Good to know

  • On multiplayer servers you don't host, she doesn't look through blocks for ores or anything else (no x-ray).
  • Free software under the GNU AGPL-3.0.