{"id":20434407,"url":"https://github.com/ssh-mitm/appimage","last_synced_at":"2026-05-10T20:04:38.694Z","repository":{"id":240194346,"uuid":"801948175","full_name":"ssh-mitm/appimage","owner":"ssh-mitm","description":"AppImage start scripts","archived":false,"fork":false,"pushed_at":"2024-05-27T12:03:38.000Z","size":60,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-19T10:11:19.277Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ssh-mitm.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-17T08:19:29.000Z","updated_at":"2025-03-11T23:42:43.000Z","dependencies_parsed_at":"2024-05-21T19:41:37.102Z","dependency_job_id":"f52792f4-a3d8-46b4-b8ae-1c113184aa8e","html_url":"https://github.com/ssh-mitm/appimage","commit_stats":null,"previous_names":["ssh-mitm/appimage"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssh-mitm%2Fappimage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssh-mitm%2Fappimage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssh-mitm%2Fappimage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssh-mitm%2Fappimage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ssh-mitm","download_url":"https://codeload.github.com/ssh-mitm/appimage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244403940,"owners_count":20447160,"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":[],"created_at":"2024-11-15T08:26:31.200Z","updated_at":"2026-05-10T20:04:38.674Z","avatar_url":"https://github.com/ssh-mitm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/ssh-mitm/appimage/main/appimage/assets/default_icon.png\" width=\"96\" height=\"96\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eappimage\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003ePackage Python applications as self-contained AppImages.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://appimage.readthedocs.io\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/ssh-mitm/appimage/main/docs/_static/readthedocslogo.png\" width=\"256\" alt=\"Read the Docs\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/appimage\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/appimage\" alt=\"PyPI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/appimage\"\u003e\u003cimg src=\"https://img.shields.io/pypi/pyversions/appimage\" alt=\"Python versions\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/ssh-mitm/appimage/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/ssh-mitm/appimage\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://appimage.readthedocs.io\"\u003e\u003cimg src=\"https://readthedocs.org/projects/appimage/badge/?version=latest\" alt=\"Documentation Status\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n`appimage` bundles a complete Python distribution together with your application and all its dependencies into a single executable file.\n\n\u003e **The same Python that uv installs.**\n\u003e The bundled interpreter comes from [python-build-standalone](https://github.com/astral-sh/python-build-standalone) — identical to what `uv python install` provides. What you develop with locally is what gets shipped in the AppImage.\n\n\n## Quick Start\n\n```sh\npip install appimage\n```\n\n**A `pyproject.toml` is all that's needed** — and if your project already has one, you're ready to build.\n`app`, `entry_point`, and `python` version are read from `[project]` automatically.\n\n```sh\n# Check what will be detected before building\npython -m appimage.build --check\n\n# Build — the AppImage is written to dist/myapp-x86_64.AppImage\npython -m appimage.build\n\n# Optionally: persist detected values to pyproject.toml to pin or adjust them\npython -m appimage.build --init\n```\n\n\n## Bundled interpreter access\n\nThe bundled Python is accessible at runtime without extracting the AppImage:\n\n```sh\n./myapp-x86_64.AppImage --python-interpreter            # interactive REPL\n./myapp-x86_64.AppImage --python-interpreter script.py  # run a script\n./myapp-x86_64.AppImage --python-interpreter -m pip list\n./myapp-x86_64.AppImage --python-list-entry-points      # list all entry points\n./myapp-x86_64.AppImage --python-entry-point other:main # switch entry point\n```\n\n\n## Virtual environments\n\nThe AppImage can act as the Python interpreter for a virtual environment. Packages installed into the venv extend the bundled ones — without repackaging the AppImage:\n\n```sh\n./myapp-x86_64.AppImage --python-interpreter -m venv ~/.venv/myapp\n~/.venv/myapp/bin/pip install extra-package\n~/.venv/myapp/bin/myapp\n```\n\nWhen launched through a venv symlink, the bundled `appimage` module activates the environment automatically.\n\n\n## Reproducible builds\n\nPin the exact Python release to get byte-for-byte reproducible AppImages:\n\n```toml\n[tool.appimage.build]\npython_date = \"20260211\"\n```\n\n\n## Configuration\n\nAll options go in `[tool.appimage.build]` inside `pyproject.toml` — every key is optional. Lifecycle hooks, extra files, custom AppRun scripts, and environment variable injection are supported.\n\n→ **[Full documentation](https://appimage.readthedocs.io)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fssh-mitm%2Fappimage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fssh-mitm%2Fappimage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fssh-mitm%2Fappimage/lists"}