installation.md

Installing uv and Python

This project is set up to use uv, the new package manager for Python. uv replaces traditional use of pyenv, pipx, poetry, pip, etc. This is a quick cheat sheet on that:

On macOS or Linux, if you don’t have uv installed, a quick way to install it:

curl -LsSf https://astral.sh/uv/install.sh | sh

On macOS, if you prefer brew, you can install or upgrade uv with:

brew update
brew install uv

See uv’s docs for more installation methods and platforms.

Now you can use uv to install a current Python environment:

uv python install 3.13 # Or pick another version.

Environment Setup

Set DEEPGRAM_API_KEY and one LLM provider key in the process environment or a .env file in the current directory or one of its parents. Use ANTHROPIC_API_KEY for the default profile or OPENAI_API_KEY for the OpenAI profile. Do not commit the file.

Run deep-transcribe models --help for the current model mappings and workspace configuration command.