{"id":22433859,"url":"https://github.com/jelmerro/tppr","last_synced_at":"2026-01-22T15:21:07.273Z","repository":{"id":266171402,"uuid":"897573988","full_name":"Jelmerro/tppr","owner":"Jelmerro","description":"Tiny Portable Python Runner for hassle-free venv and dep handling","archived":false,"fork":false,"pushed_at":"2025-01-15T20:48:44.000Z","size":12,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-01T06:55:15.051Z","etag":null,"topics":["bash","pip","python","python-venv","virtual-env"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jelmerro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"jelmerro","github":"jelmerro"}},"created_at":"2024-12-02T21:34:01.000Z","updated_at":"2025-01-15T20:48:45.000Z","dependencies_parsed_at":"2024-12-03T00:23:21.106Z","dependency_job_id":"6b3c4e82-72fd-4d3f-9f78-f76a8f5bfc2f","html_url":"https://github.com/Jelmerro/tppr","commit_stats":null,"previous_names":["jelmerro/tppr"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jelmerro%2Ftppr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jelmerro%2Ftppr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jelmerro%2Ftppr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jelmerro%2Ftppr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jelmerro","download_url":"https://codeload.github.com/Jelmerro/tppr/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236664610,"owners_count":19185520,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","pip","python","python-venv","virtual-env"],"created_at":"2024-12-05T22:16:09.794Z","updated_at":"2026-01-22T15:21:07.254Z","avatar_url":"https://github.com/Jelmerro.png","language":"Shell","funding_links":["https://ko-fi.com/jelmerro","https://github.com/sponsors/jelmerro","https://ko-fi.com/Jelmerro","https://github.com/sponsors/Jelmerro"],"categories":[],"sub_categories":[],"readme":"tppr\n====\n\nTiny Portable Python Runner for hassle-free venv and dep handling\n\n## Features\n\n- Tiny command-line bash script to create and update venv versions\n- Check if an existing venv (virtual env) is present and use that to run\n- Automatically create/recreate the venv if needed (such as after updating Python)\n- Installs dependencies from both requirements.txt and pyproject.toml in the venv\n- Runs the provided file as-is within the activated venv without calling cd ever\n- Supports the -c Python argument to pass code directly and have it run in the venv\n\n## Install\n\n### Curl\n\n```bash\ncurl -L https://raw.githubusercontent.com/Jelmerro/tppr/refs/heads/master/tppr -o ~/.local/bin/tppr\nchmod +x ~/.local/bin/tppr\n```\n\n### [Github](https://github.com/Jelmerro/tppr/releases)\n\nDownload a stable installer or executable for your platform from Github.\n\n### [Fedora](https://jelmerro.nl/fedora)\n\nI host a custom Fedora repository that you can use for automatic updates.\n\n```bash\nsudo dnf config-manager addrepo --from-repofile=https://jelmerro.nl/fedora/jelmerro.repo\nsudo dnf install tppr\n```\n\n## Usage\n\nOnce installed, simply run `tppr` with a Python script as an argument.\nThis will make a venv with Python and all the deps, then run the script with it.\nWith `tppr ~/projects/example/file.py \u003cargs\u003e` you can pass all args to the Python script.\nYou can also supply options to tppr if you include them before the filename,\nplease see `tppr -h` for help, advanced usage and additional options.\n\n## Contribute\n\nYou can support my work on [ko-fi](https://ko-fi.com/Jelmerro) or [Github sponsors](https://github.com/sponsors/Jelmerro).\nAnother way to help is to report issues or suggest new features.\nPlease try to follow recommendations by shellcheck when developing.\nFor an example vimrc that can auto-format based on the included linters,\nyou can check out my personal [vimrc](https://github.com/Jelmerro/vimrc).\n\n## Building\n\nTo create your own builds you can use [jfpm](https://github.com/Jelmerro/jfpm).\nPlease clone or download both this repo and jfpm, then run `../jfpm/release_sh_simple.sh`.\nThis will build releases for various platforms and output them to `dist`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjelmerro%2Ftppr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjelmerro%2Ftppr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjelmerro%2Ftppr/lists"}