macOS build instructions

[foreverigor]

I managed to build & run on macOS so I'm sharing:

It didn't work with the latest version of python, something related to dependencies, but 3.10 works so try with that. I recommend using mise for installation of python, it can also handle the rest of the build. Using mise, this is how you build on macOS (and potentially linux)

Put this into a file called .mise.toml in the project directory

[tools]
python = "3.10"

[env]
_.python.venv = { path = ".venv", create = true }

[tasks.tagstudio]
run = "pip install -r requirements.txt && python tagstudio/tagstudio.py"

and then run (with installed mise) mise trust && mise install, this will install python and create the venv and you can run the normal linux/ macos build instruction, or alternatively use mise run --yes tagstudio one-liner

the app & gui starts but looks a little fucky

[OleMortensen8]

I run in python 3.11 so... it might at least work up till that version.

[WardsParadox]

You can also declare your items as dependencies in the pyproject.toml file.

Would recommend using uv alongside mise (or rye) to create better Venv environments. Using the pyproject.toml to declare dependencies allows much easier updates over time. It's also one file where you can declare your build steps.

[williamtcastro]

I got it working on 3.12 on my macOS machine and created a build script to generate a .app version of the project PR-76

[yedpodtrzitko]

this can be probably also closed since we have binaries.