https://github.com/daniel-brai/loco
Expose your localhost to the world with zero configuration with fast, secure tunneling for those who need their local apps accessible anywhere.
https://github.com/daniel-brai/loco
cli devtools localhost loco networking python tunneling
Last synced: 2 months ago
JSON representation
Expose your localhost to the world with zero configuration with fast, secure tunneling for those who need their local apps accessible anywhere.
- Host: GitHub
- URL: https://github.com/daniel-brai/loco
- Owner: Daniel-Brai
- License: mit
- Created: 2025-06-09T16:22:38.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-13T12:04:33.000Z (4 months ago)
- Last Synced: 2025-07-08T03:44:36.699Z (3 months ago)
- Topics: cli, devtools, localhost, loco, networking, python, tunneling
- Language: Python
- Homepage:
- Size: 188 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Loco
[](https://github.com/Daniel-Brai/Loco/actions/workflows/ci.yml)
[](https://codecov.io/gh/Daniel-Brai/Loco)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
Fast, reliable localhost tunneling for web developers
Loco makes it dead simple to expose your local web applications to the internet.
Built with Python for simplicity, whether you're testing webhooks,
sharing work-in-progress with clients, or accessing your dev environment remotely,
Loco gets you there without the hassle.
## Why Loco?
- **Zero configuration** - Works out of the box
- **Lightning fast** - Optimized Python implementation with asyncio
- **Secure by default** - Built-in HTTPS and authentication
- **Developer friendly** - Clean CLI, detailed logs, easy integration
- **Rock solid** - Stable tunnels that don't drop connections
- **Pure Python** - Easy to install, modify, and extend
## Installation
### Requirements
- Python 3.12 or higher
- Linux, macOS, or Windows
### Install from PyPI (recommended)
```bash
pip install loco
```
### Build and Install from Source
1. Clone the repository:
```bash
git clone https://github.com/Daniel-Brai/Loco.git
cd Loco
```
2. Install dependencies and build:
```bash
# Using pip
pip install -e .
# Using uv (recommended)
uv pip install -e .
```
### Development Setup
1. Clone the repository:
```bash
git clone https://github.com/Daniel-Brai/Loco.git
cd Loco
```
2. Create a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. Install development dependencies:
```bash
# Using pip
pip install -e ".[dev]"
# Using uv
uv pip install -e ".[dev]"
```
4. Set up pre-commit hooks:
```bash
pre-commit install
```
### Verify Installation
After installation, verify that Loco is working:
```bash
loco --version
```
This should display the Loco banner with version information.
## TODO
- [ ] Add support for custom domains (This may require DNS configuration or require me to set up a custom DNS service)
- [ ] Implement advanced authentication options
- [ ] Improve error handling and logging
- [ ] Add more detailed documentation
- [ ] Add more tests
- [ ] Add proper packaging for PyPI