## The problem
Issue stormkit-io/stormkit-io#5 (closed, 8 comments): A contributor setting up Stormkit locally hit two problems: after mise install reported success, go was still not found because the mise shims were not activated in the shell, and the hosting service crashed on startup with pkg-config: executable file not found because the bimg image-processing library needs libvips system libraries. The fixes: add eval "$(mise activate zsh)" to the shell config, and brew install vips pkg-config on macOS. The reporter also found the README outdated and a hosts-file tweak needed for the /instance and /providers APIs. The maintainer thanked them and agreed to update the docs.

## The fix
Setting up Stormkit locally and something is off? Two common gotchas from a contributor's report. First, if mise install says everything is installed but go is still not found, the mise shims are not active in your shell: add eval "$(mise activate zsh)" to your shell config, reload it, and verify with which go. Second, if the hosting service crashes immediately with pkg-config: executable file not found, that comes from the bimg image-processing library, which needs libvips system libraries: on macOS run brew install vips pkg-config, verify with pkg-config --modversion vips, then restart with ./scripts/start.sh. Also check the current README before following older guides, and if the /instance and /providers APIs return 500s, your hosts file may need the documented local entries.

## Notes
Thread: https://github.com/stormkit-io/stormkit-io/issues/5. Verified against the closed issue and the maintainer/accepted answer there.