{"id":35189442,"url":"https://github.com/mathnodes/meile-gui","last_synced_at":"2026-05-14T05:02:10.414Z","repository":{"id":43552219,"uuid":"496778216","full_name":"MathNodes/meile-gui","owner":"MathNodes","description":"Meile dVPN GUI for Linux, OS X, and Windows - Powered by the Sentinel Network","archived":false,"fork":false,"pushed_at":"2026-04-01T02:36:04.000Z","size":548322,"stargazers_count":46,"open_issues_count":13,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-04-01T04:59:37.457Z","etag":null,"topics":["blockchain","dvpn","dvpn-client","gui","privacy","vpn","vpn-client"],"latest_commit_sha":null,"homepage":"https://meile.app","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/MathNodes.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-05-26T21:35:06.000Z","updated_at":"2026-02-02T22:50:02.000Z","dependencies_parsed_at":"2023-10-05T08:26:53.532Z","dependency_job_id":"86622310-9e2d-4b1f-96f7-69de9e37f302","html_url":"https://github.com/MathNodes/meile-gui","commit_stats":null,"previous_names":[],"tags_count":123,"template":false,"template_full_name":null,"purl":"pkg:github/MathNodes/meile-gui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MathNodes%2Fmeile-gui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MathNodes%2Fmeile-gui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MathNodes%2Fmeile-gui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MathNodes%2Fmeile-gui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MathNodes","download_url":"https://codeload.github.com/MathNodes/meile-gui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MathNodes%2Fmeile-gui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31318151,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T21:35:00.834Z","status":"ssl_error","status_checked_at":"2026-04-02T21:34:59.806Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["blockchain","dvpn","dvpn-client","gui","privacy","vpn","vpn-client"],"created_at":"2025-12-29T05:31:02.691Z","updated_at":"2026-04-02T23:03:41.448Z","avatar_url":"https://github.com/MathNodes.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Meile-GUI (may•lah)\n========================\n\n[![Github All Releases](https://img.shields.io/github/downloads/mathnodes/meile-gui/total?style=for-the-badge)](https://github.com/MathNodes/meile-gui/releases)\n[![GitHub license](https://img.shields.io/github/license/mathnodes/meile-gui?style=for-the-badge)](https://github.com/MathNodes/meile-gui/blob/main/LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/network)\n[![GitHub issues](https://img.shields.io/github/issues/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/issues)\n\n[![Downloads](https://static.pepy.tech/personalized-badge/meile-gui?period=total\u0026units=international_system\u0026left_color=black\u0026right_color=orange\u0026left_text=pip)](https://pepy.tech/project/meile-gui)\n[![Downloads](https://static.pepy.tech/personalized-badge/meile-gui?period=month\u0026units=international_system\u0026left_color=black\u0026right_color=orange\u0026left_text=pip%20(month))](https://pepy.tech/project/meile-gui)\n\nMeile dVPN GUI for Linux, OS X, and Windows - Powered by the Sentinel Network - a blockchain decentralized VPN. \n\n# Full Version\n\nThe full version 1.8.0 has been released to GitHub. Branches include **main**, **osx-fiat-intel**, **windows**, **fiat**, **osx-fiat**, **pip**. The exception is that we did not include the scrtsxx.py which contains credentials for the FIAT gateway. Please navigate the various branches to understand the different interworkings. It is our intention to eventually merge all branches into a unified code source. \n\n## Windows\n\nThe current release is version **1.8.0**. Please note this does not use Windows APIs to ask for Administration privileges and relies on an open source implementation called \"gsudo\". Gsudo is just a hack to ask the user to modify network adapters so that Meile may connect without issue. \n\nAlso, Meile opens a debug console in the background. Do not close this otherwise the app will close as well. We are working on getting a Microsoft Developers Certificate so we may sign the app for official release. Also, when we get the certificate we will eliminate the debug console as well. We also have plans to integrate an MSI installer package. This is all in the works. \n\nDownload: [Meile for Windows (v1.8.0)](https://github.com/MathNodes/meile-gui/releases/tag/v1.8.0)\n\n## Mac OS X\n\nDownload the latest release as a DMG: [Mac OS X v1.8.0](https://github.com/MathNodes/meile-gui/releases/tag/v1.8.0)\n\nThe OS X M1/M2 and Intel builds are packaged as a disk image (DMG). To install, simply download the correct DMG for your architecture (Intel or Apple Silicon [arm]). Double click on the DMG file and move the Meile app bundle to your desktop or to the Applications folder. \n\nBoth the OS X Intel and Apple Silicon release are signed by a Apple Developer Certificate. There should be no errors when running these. \n\n### NOTE:\n\npip install is not currently available for Mac OS X or Windows. We are working on bringing this as a separate packages. \n\n## Debian .deb package\n\nThe latest version of Meile GUI comes packaged as a Debian archive. Simply download the latest release: [Meile Releases](https://github.com/MathNodes/meile-gui/releases/)\n\nand run apt for your build:\n\n```shell\nsudo apt install -y ./meile-gui-v1.8.0_ubuntu22.04_amd64.deb\n```\n\nThis release will install wireguard tools, resolvconf, curl, and net-tools alongside the Meile GUI. To connect to nodes or disconnect requires \"sudo\" privileges. You will be prompted by your system dialog to enter your username's password to give authorization to complete the connection. This is due to how Linux handles permissions with regards to network interfaces. \n\n### Run\n\n```shell\nmeile-gui\n```\n\nOr goto your panel menu under Internet and there will be a clickable icon. \n\n## Debian Virtual Machine (.deb)\n\nBecause there were issues loading certain mesa OpenGL drivers in various Debian Virtual Machines, we have included a separate .deb archive that automatically configures the system to handle the Meile dependencies. Please use this version if you are running a Debian flavor in a virutal machine (VM).\n\n[Debian/Ubuntu 20.04 Virtual Machine](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0_ubuntu2004_amd64_vm.deb)\n\n[Debian/Ubuntu 22.04 Virtual Machine](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0_ubuntu2204_amd64_vm.deb)\n\n## Redhat/CentOS/Fedora (.rpm)\n\nDownload the latest RPM for RedHat releases:\n\n[RedHat RPM (fc36)](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0-1.fc36.x86_64.rpm)\n\n[RedHat RPM (fc37)](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0-1.fc37.x86_64.rpm)\n\nInstall the rpm from a terminal via *dnf* (**RECOMMENDED**):\n\n```shell\nsudo dnf install meile-gui-v1.8.0-1.fc36.x86_64.rpm\n```\n\nor via *rpm*:\n\n```shell\nsudo rpm -i meile-gui-v1.8.0-1.fc36.x86_64.rpm\n```\n\n*dnf* is **recommended** as it will install all dependencies for Meile to function correctly.\n\n# Arch Linux (.zst)\n\nOur wonderful community member and part-time developer @Tkd-Alex has graciously taken on the role of compiling an Arch Linux package. The current release version is **1.8.0** and can be downloaded from: [Meile Arch Linux Release](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-1.8.0-1-x86_64.pkg.tar.zst)\n\nTo install, run:\n\n```shell\nsudo pacman -U --noconfirm meile-gui-1.8.0-1-x86_64.pkg.tar.zst\n```\n\n## Installing via pip\n\n**Requirements:** python\u003c=3.10\n\n**Recommended:** python==3.10.x\n\nTo install python3.10 on Ubuntu 20.04/Fedora 36 or older follow the instructions here:\n\n\n[Install python3.10 as python on ubuntu 20.04 · GitHub](https://gist.github.com/ant1fact/8fdacea1b925ec9219cb04467783b18c)\n\n\n\nMeile dVPN GUI v0.15.0.0 is now available as a pip packages as well. These are pre-releases scheduled to be built into a binary for the various platforms. First install system dependencies:\n\n```shell\nsudo apt install -y  wireguard-tools openresolv mesa-utils libgl1-mesa-glx xclip python3-dev curl net-tools python3.10-venv build-essential\n```\n\nThen install via pip\n\n```shell\npip3 install meile-gui\n```\n\nvia a virtual environment:\n\n```shell\nmkdir ~/venv \u0026\u0026 python3 -m venv ~/venv/meile\nsource ~/venv/meile/bin/activate\npip3 install meile-gui\n```\n\nUpgrade via pip\n\n```shell\npip3 install meile-gui --upgrade\n```\n\nTo run Meile GUI after pip install do the following:\n\n```shell\nmeile-gui\n```\n\n### NOTE:\n\nThe FIAT gateway is not included in the pip package. This is due to certain credentials needing to remain secret for OPSEC reasons. The pip package will continue to get updated without the FIAT gateway with bug fixes and feature additions. \n\nWe consider the pip releases to be pre-releases of the compiled binaries. Pip is considered the bleeding edge of Meile releases\n\n### Packaged Binaries\n\nWe package the following binaries with our releases:\n\n* tun2socks([GitHub - xjasonlyu/tun2socks: tun2socks - powered by gVisor TCP/IP stack](https://github.com/xjasonlyu/tun2socks))\n\n* v2ray ([GitHub - v2fly/v2ray-core: A platform for building proxies to bypass network restrictions.](https://github.com/v2fly/v2ray-core))\n\n* sentinel-cli ([GitHub - sentinel-official/cli-client: The official Sentinel CLI client](https://github.com/sentinel-official/cli-client))\n\n* warp ([Download WARP · Cloudflare Zero Trust docs](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/download-warp/))\n\n* gsudo ([GitHub - gerardog/gsudo: Sudo for Windows](https://github.com/gerardog/gsudo))\n\nWe have built tun2socks, v2ray, and sentinel-cli from source on the target architectures. Cloudflare warp is closed-source and so we packaged the binaries direct from the install link above. For windows we downloaded the pre-built gsudo binary from the above github. \n\n**Note:** we use **v2ray** version **5.1.0** as this is what the dvpn-node software also uses and it is recommended to use the same client version as the server version.\n\n## Help\n\nPlease make comments, suggestions, and issues on the issues page here at GitHub. If you are a GitHub newb, you can join us in our various open messaging channels:\n\n* Telegram [MathNodes-Telegram](http://t.me/MathNodes)\n* Discord [MathNodes-Discord](https://discord.gg/HQrHXZJHQq) in the Meile channel, \n* Session [Session Open Group](http://session.mathnodes.com/mathnodes-dvpn-oxen-dero?public_key=8585d7f3fb44f4f40fb1685a0cf10627dd24467a9379eafbb7ba08e5607e9c21)\n\nSession:\n![session](./img/session_qr.png)\n\nAll suggestions are welcome.\n\n## Creating a Binary for your distribution:\n\nIn order to create a binary for your distribution some packages need to be installed first.\n\nPyinstaller:\n\n```shell\npip3 install pyinstaller\n```\n\nInstall a python virtualenv:\n\n```shell\nsudo apt install python3-venv\n```\n\nThen clone the repo:\n\n```shell\ngit clone https://github.com/MathNodes/meile-gui\n```\n\nSwitch to the pip branch as this is the one without FIAT gateway\n\n```\ncd meile-gui \u0026\u0026 git checkout pip\n```\n\nThen run a python virtual environment and install meile-gui. This will find all the dependencies for **meile-gui**.\n\n```shell\npython3 -m venv meile-gui \u0026\u0026 \\\nsource meile-gui/bin/activate \u0026\u0026 \\ \npip install -r requriements.txt  \u0026\u0026 pip install -e .\n```\n\nOnce meile-gui and it's dependencies have been installed within the python virutal environment, a binary release can be created:\n\n```shell\nbash pyinstaller.cmd\n```\n\nThat's it. Navigate to the `dist` folder where the binary will be. \n\n### Windows\n\nFor windows, install the necessary pip packages found in `setup.py` and run the following with `pyinstaller`\n\n```shell\npyinstaller meile_gui.spec\n```\n\nThis will build the binary found in the `dist` directory of the Meile tree. \n\n# Donations\n\nBecause we are working on a small grant with no VC funding, any additional contributions to our developer team is more than certainly welcomed. It will help fund future releases. \n\n## BTC (Bitcoin)\n\n```\nbc1qtvc9l3cr9u4qg6uwe6pvv7jufvsnn0xxpdyftl\n```\n\n![BTC](./img/BTC.png)\n\n## DVPN (Sentinel)\n\n```\nsent12v8ghhg98e2n0chyje3su4uqlsg75sh4lwcyww\n```\n\n![dvpn](./img/DVPN.png)\n\n## XMR (Monero)\n\n```\n87qHJPU5dZGWaWzuoC3My5SgoQSuxh4sHSv1FXRZrQ9XZHWnfC33EX1NLv5HujpVhbPbbF9RcXXD94byT18HonAQ75b9dyR\n```\n\n![xmr](./img/XMR.png)\n\n## ARRR (Pirate Chain)\n\n```\nzs1gn457262c52z5xa666k77zafqmke0hd60qvc38dk48w9fx378h4zjs5rrwnl0x8qazj4q3x4svz\n```\n\n![ARRR](./img/ARRR.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathnodes%2Fmeile-gui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmathnodes%2Fmeile-gui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathnodes%2Fmeile-gui/lists"}