{"id":22119603,"url":"https://github.com/pleiszenburg/wenv","last_synced_at":"2026-04-02T01:59:57.670Z","repository":{"id":44994413,"uuid":"226121463","full_name":"pleiszenburg/wenv","owner":"pleiszenburg","description":"Running Python on Wine","archived":false,"fork":false,"pushed_at":"2022-12-26T22:07:50.000Z","size":524,"stargazers_count":28,"open_issues_count":18,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-22T07:04:19.303Z","etag":null,"topics":["cross-platform","python","python-package","wine"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pleiszenburg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-12-05T14:32:13.000Z","updated_at":"2025-06-17T11:17:14.000Z","dependencies_parsed_at":"2023-01-31T02:01:00.960Z","dependency_job_id":null,"html_url":"https://github.com/pleiszenburg/wenv","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/pleiszenburg/wenv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pleiszenburg%2Fwenv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pleiszenburg%2Fwenv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pleiszenburg%2Fwenv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pleiszenburg%2Fwenv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pleiszenburg","download_url":"https://codeload.github.com/pleiszenburg/wenv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pleiszenburg%2Fwenv/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266796481,"owners_count":23985474,"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","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cross-platform","python","python-package","wine"],"created_at":"2024-12-01T14:16:02.635Z","updated_at":"2026-04-02T01:59:57.635Z","avatar_url":"https://github.com/pleiszenburg.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![wenv](docs/source/_static/logo.png \"wenv logo\")\n\n# wenv - Running Python on Wine\n\n[![build_master](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml/badge.svg?branch=master \"Build Status: master / release\")](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml)\n[![docs_master](https://readthedocs.org/projects/wenv/badge/?version=latest\u0026style=flat-square \"Documentation Status: master / release\")](https://wenv.readthedocs.io/en/latest/)\n[![license](https://img.shields.io/pypi/l/wenv.svg?style=flat-square \"GNU Lesser General Public License v2.1\")](https://github.com/pleiszenburg/wenv/blob/master/LICENSE)\n[![status](https://img.shields.io/pypi/status/wenv.svg?style=flat-square \"Project Development Status\")](https://github.com/pleiszenburg/wenv/issues)\n[![pypi_version](https://img.shields.io/pypi/v/wenv.svg?style=flat-square \"Project Development Status\")](https://pypi.python.org/pypi/wenv)\n[![pypi_versions](https://img.shields.io/pypi/pyversions/wenv.svg?style=flat-square \"Available on PyPi - the Python Package Index\")](https://pypi.python.org/pypi/wenv)\n[![chat](https://img.shields.io/matrix/zugbruecke:matrix.org.svg?style=flat-square \"Matrix Chat Room\")](https://matrix.to/#/#zugbruecke:matrix.org)\n[![mailing_list](https://img.shields.io/badge/mailing%20list-groups.io-8cbcd1.svg?style=flat-square \"Mailing List\")](https://groups.io/g/zugbruecke-dev)\n\n## Synopsis\n\n**wenv** is a **Python package** (currently in development **status 4/beta**). It allows to **run Python on top of Wine** on Linux, MacOS or BSD. It handles required plumbing related to making Python and a number of Python modules work on Wine. `wenv` creates isolated virtual environments which can be transparently used from a Unix command line and which seamlessly integrate into Unix Python virtual environments.\n\nAbout Wine (from [winehq.org](https://www.winehq.org/)): *Wine (originally an acronym for \"Wine Is Not an Emulator\") is a compatibility layer capable of running Windows applications on several POSIX-compliant operating systems, such as Linux, MacOS and BSD. Instead of simulating internal Windows logic like a virtual machine or emulator, Wine translates Windows API calls into POSIX calls on-the-fly, eliminating the performance and memory penalties of other methods and allowing you to cleanly integrate Windows applications into your desktop.*\n\n**This project is NEITHER associated NOR affiliated in any way or form with the Wine project.**\n\n## Prerequisites\n\n| prerequisite | version |\n| --- | --- |\n| [CPython](https://www.python.org/) | 3.x (tested with 3.{7,8,9,10}) |\n| [Wine](https://www.winehq.org/) | \u003e= 6.x (tested with regular \u0026 [staging](https://wine-staging.com/)) - expected to be in the user's [`PATH`](https://en.wikipedia.org/wiki/PATH_(variable)) |\n\n## Installation\n\n| branch | status | installation | documentation |\n| --- | --- | --- | --- |\n| master (release) | [![build_master](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml/badge.svg?branch=master \"Build Status: master / release\")](https://github.com/pleiszenburg/wenv/tree/master) | `pip install wenv` | [![docs_master](https://readthedocs.org/projects/wenv/badge/?version=latest\u0026style=flat-square \"Documentation Status: master / release\")](https://wenv.readthedocs.io/en/latest/) |\n| develop | [![build_develop](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml/badge.svg?branch=develop \"Build Status: development branch\")](https://github.com/pleiszenburg/wenv/tree/develop) | `pip install git+https://github.com/pleiszenburg/wenv.git@develop` | [![docs_develop](https://readthedocs.org/projects/wenv/badge/?version=develop\u0026style=flat-square \"Documentation Status: development branch\")](https://wenv.readthedocs.io/en/develop/) |\n\nAfter installing the package with `pip`, you must initialize the *Wine Python environment* by running `wenv init`.\n\n## Examples\n\nFire up a shell and try the following:\n\n```bash\n(env) user@comp:~\u003e uname\nLinux\n(env) user@comp:~\u003e python -m platform\nLinux\n(env) user@comp:~\u003e wenv python -m platform\nWindows\n```\n\n`wenv pip` works just like one would expect. Have a look at the output of `wenv help` for more commands and information. For use as a shebang, `wenv python` has an alias: One can write `#!/usr/bin/env _wenv_python` at the top of scripts.\n\n``wenv python`` can also be used as a **Jupyter kernel**, side-by-side with a Unix-version of Python. Have a look at the [wenv-kernel project](https://github.com/pleiszenburg/wenv-kernel).\n\n## Security\n\nJust like Wine, `wenv` can run malicious Windows software on Unix. **Never, ever, run `wenv` with root / super users privileges!** For details, check the section on [security](https://wenv.readthedocs.io/en/stable/security.html) in the documentation.\n\n## Need help?\n\nSee section on [Getting Help](https://wenv.readthedocs.io/en/latest/support.html) on `wenv`'s documentation.\n\n## Bugs \u0026 Issues\n\nSee section on [Bugs and Issues](https://wenv.readthedocs.io/en/stable/bugs.html) on `wenv`'s documentation.\n\n## Miscellaneous\n\n- Full project documentation\n    - at [Read the Docs](https://wenv.readthedocs.io/en/latest/)\n    - at [`wenv` repository](https://github.com/pleiszenburg/wenv/blob/master/docs/source/index.rst)\n- [Authors](https://github.com/pleiszenburg/wenv/blob/master/AUTHORS.md)\n- [Change log (current)](https://github.com/pleiszenburg/wenv/blob/develop/CHANGES.md) (changes in development branch since last release)\n- [Change log (past)](https://github.com/pleiszenburg/wenv/blob/master/CHANGES.md) (release history)\n- [Contributing](https://github.com/pleiszenburg/wenv/blob/master/CONTRIBUTING.md) (**Contributions are highly welcomed!**)\n- [FAQ](https://wenv.readthedocs.io/en/stable/faq.html)\n- [License](https://github.com/pleiszenburg/wenv/blob/master/LICENSE) (**LGPL v2.1**)\n- [Upstream issues](https://github.com/pleiszenburg/wenv/issues?q=is%3Aissue+is%3Aopen+label%3Aupstream) (relevant bugs in dependencies)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpleiszenburg%2Fwenv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpleiszenburg%2Fwenv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpleiszenburg%2Fwenv/lists"}