https://github.com/fulviofreitas/eero-api
Python API client for Eero mesh routers
https://github.com/fulviofreitas/eero-api
api-client async asyncio eero home-automation iot mesh-network networking pydantic python python3 smart-home wifi
Last synced: 2 months ago
JSON representation
Python API client for Eero mesh routers
- Host: GitHub
- URL: https://github.com/fulviofreitas/eero-api
- Owner: fulviofreitas
- License: mit
- Created: 2026-01-18T05:00:22.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-04-19T03:22:12.000Z (2 months ago)
- Last Synced: 2026-04-19T05:22:41.175Z (2 months ago)
- Topics: api-client, async, asyncio, eero, home-automation, iot, mesh-network, networking, pydantic, python, python3, smart-home, wifi
- Language: Python
- Homepage:
- Size: 576 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐍 Eero API
**Your async Python toolkit for Eero mesh networks**
[](https://python.org)
[](https://pypi.org/project/eero-api/)
[](LICENSE)
---
_A modern, async-first Python SDK for the Eero mesh WiFi API._
_Raw JSON responses, system keyring integration, and smart caching._
[Get Started](#-quick-start) · [Documentation](#-docs) · [Ecosystem](#-ecosystem) · [License](#-license)
---
## ⚡ Why Eero API?
- 🚀 **Async-first** — Non-blocking, blazing fast
- 🔐 **Secure** — System keyring for credentials
- 📦 **Raw JSON** — Direct API responses, no transformations
- ⚡ **Smart caching** — Snappy responses
## 📦 Install
```bash
pip install eero-api
# or with uv
uv add eero-api
```
## 🚀 Quick Start
```python
import asyncio
from eero import EeroClient
async def main():
async with EeroClient() as client:
if not client.is_authenticated:
await client.login("you@example.com")
await client.verify(input("Code: "))
# All methods return raw JSON responses
response = await client.get_networks()
networks = response.get("data", {}).get("networks", [])
for network in networks:
print(f"📶 {network['name']}: {network.get('status')}")
asyncio.run(main())
```
> 💡 Credentials are auto-saved to your system keyring
## 📄 Raw Response Format
All API methods return the exact JSON from Eero's API:
```python
{
"meta": {"code": 200, "server_time": "..."},
"data": {
# Endpoint-specific payload
}
}
```
See [MIGRATION.md](MIGRATION.md) for details on the raw response architecture.
## 📚 Docs
| Guide | What's inside |
|-------|---------------|
| **[📖 Python API](../../wiki/Python-API)** | Full API reference |
| **[⚙️ Configuration](../../wiki/Configuration)** | Auth & settings |
| **[🔧 Troubleshooting](../../wiki/Troubleshooting)** | Common fixes |
| **[🔄 Migration Guide](MIGRATION.md)** | v1.x → v2.0 migration |
| **[🏠 Wiki Home](../../wiki)** | All documentation |
## 🔗 Ecosystem
| Project | Description |
|---------|-------------|
| **[🖥️ eero-cli](https://github.com/fulviofreitas/eero-cli)** | Terminal interface for Eero networks |
| **[🛜 eero-ui](https://github.com/fulviofreitas/eero-ui)** | Svelte dashboard for network management |
| **[📊 eero-prometheus-exporter](https://github.com/fulviofreitas/eero-prometheus-exporter)** | Prometheus metrics for monitoring |
## ⚠️ Important Notes
> **Unofficial Project**: This library uses reverse-engineered APIs and is not affiliated with or endorsed by Eero.
> **Amazon Login Limitation**: If your Eero account uses Amazon for login, this library may not work directly due to API limitations. **Workaround**: Have someone in your household create a standard Eero account (with email/password) and invite them as an admin to your network. Then use those credentials to authenticate.
## 📄 License
[MIT](LICENSE) — Use it, fork it, build cool stuff 🎉
---
## 📊 Repository Metrics
