freebox-api
Provides asynchronous authentication and access to Freebox servers
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has low install friction, covers a specific and useful niche (Freebox control), and carries no known vulnerabilities. The copyleft GPL v3 license is a consideration if you plan to redistribute modified versions, but poses no barrier to private use. Install if you own or manage a Freebox and need programmatic control or monitoring.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Async/await syntax required; synchronous code must wrap calls with asyncio.run() or equivalent event loop.
- Low friction install with only two runtime dependencies (aiohttp and importlib-metadata).
License · maintenance · safety
GNU GPL v3 (copyleft) — Licensed under GNU GPL v3 (copyleft). You must distribute any modifications under the same license and make source code available to users.
last release 2026-03-30 (137 days) · last repo commit 2026-08-13 · 53 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 75,967 downloads/mo, #14,664 on PyPI
Alternatives
Verify before relying
pip install freebox-api
from freebox_api import Freepybox
async def example():
fbx = Freepybox()
await fbx.open('192.168.0.254')
await fbx.system.reboot()
await fbx.close()- Exact scope of Freebox OS API coverage (which endpoints/features are wrapped)
- Whether certificate pinning for fbxos.fr domains is automatic or requires configuration
- Performance characteristics under high-frequency monitoring or large contact/call datasets
What it is and what it does
freebox-api is an asynchronous Python client for the Freebox OS API, the control interface for Freebox routers (and compatible iliadbox devices). It handles the authentication handshake with the Freebox and exposes its API surface—calls, contacts, DHCP configuration, WiFi control, LAN monitoring, and system operations like reboot—through async/await methods, usable both on the local network and remotely.
The library wraps aiohttp for HTTP communication and relies on importlib-metadata for version introspection. It is built on the same API surface as the earlier synchronous freepybox project but designed for non-blocking I/O. The package supports Python 3.10 through 3.14 and is actively maintained.
Use it for
- Automate Freebox router administration tasks (WiFi toggle, DHCP reconfiguration, system reboot) from Python scripts or services.
- Monitor Freebox call logs and contact lists programmatically for integration with home automation or notification systems.
- Build remote management dashboards or CLI tools that query Freebox LAN activity and device status over the network.
- Integrate Freebox control into Home Assistant or other async-first home automation frameworks.
- Develop multi-device network monitoring that polls Freebox metrics alongside other router or IoT APIs.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has low install friction, covers a specific and useful niche (Freebox control), and carries no known vulnerabilities. The copyleft GPL v3 license is a consideration if you plan to redistribute modified versions, but poses no barrier to private use. Install if you own or manage a Freebox and need programmatic control or monitoring.
Install
freebox-api on PyPI
Before you install
Low friction install with only two runtime dependencies (aiohttp and importlib-metadata). Active maintenance with last commit on 2026-08-13; repository is not archived and has 53 stars.
Requires Python 3.10 or later. Async/await syntax required; synchronous code must wrap calls with asyncio.run() or equivalent event loop.
License in practice
Licensed under GNU GPL v3 (copyleft). You must distribute any modifications under the same license and make source code available to users.
Quickstart
pip install freebox-api
from freebox_api import Freepybox
async def example():
fbx = Freepybox()
await fbx.open('192.168.0.254')
await fbx.system.reboot()
await fbx.close()Verify before relying
- Exact scope of Freebox OS API coverage (which endpoints/features are wrapped)
- Whether certificate pinning for fbxos.fr domains is automatic or requires configuration
- Performance characteristics under high-frequency monitoring or large contact/call datasets
Package facts
| License | GNU GPL v3 copyleft |
| Python support | Supports the current Python release <4.0,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesaiohttpimportlib-metadata |
| Maintenance | Actively maintained 137 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 75,967 / month, #14,664 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableFramework :: AsyncIOIntended Audience :: DevelopersIntended Audience :: System AdministratorsLicense :: OSI Approved :: GNU General Public License (GPL)License :: Other/Proprietary LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Home Automation |
Evidence: freebox_api-1.3.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “freebox router control python”
- freebox-apiAsynchronous Python library for authenticating with and controlling…
- aiovodafoneAsync Python library for controlling and monitoring Vodafone Station…
- asusrouterAsynchronous API wrapper for querying and controlling ASUSWRT-powered…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also sfrbox-api · infoblox-client · directv · yeelight · python-ecobee-api · asusrouter · rokuecp · aiolifx · pyipp · glances-api