---
id: librouteros
version: "4.1.1"
license: GPL-2.0-or-later
license_treatment: copyleft
maintenance: active
---

# librouteros — Python implementation of MikroTik RouterOS API

License: copyleft · Maintenance: active · Downloads: 146.1K/mo

## What it is and what it does

librouteros provides a Python interface to MikroTik RouterOS devices via their API. It abstracts the low-level protocol details, allowing developers to query and configure network settings, interfaces, firewall rules, and other RouterOS features programmatically rather than through the web UI or SSH.

The package has been in development since 2016 and is actively maintained. It carries no runtime dependencies beyond Python itself, making it lightweight to install. The copyleft license means it's suitable for open-source and internal projects but requires careful consideration in proprietary contexts.

Use it for:

- Automate bulk configuration changes across multiple MikroTik devices in a network.
- Build monitoring dashboards that query RouterOS statistics and interface status in real time.
- Integrate MikroTik device management into larger network orchestration or infrastructure-as-code workflows.
- Script routine maintenance tasks like backup, firewall rule updates, or user provisioning on RouterOS systems.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

librouteros is a Python client library for the MikroTik RouterOS API, enabling programmatic control and configuration of MikroTik network devices.

Yes, if you need to programmatically manage MikroTik RouterOS devices and accept the GPL-2.0-or-later copyleft license. The package is actively maintained, has no external dependencies, installs easily, and is in the top 15000 PyPI packages by download volume. Verify that your use case aligns with the copyleft terms before adoption.

## Install

pip install librouteros
uv add librouteros
poetry add librouteros

## Installing librouteros

Before you install: Low install friction with a pure-Python wheel. The package is actively maintained with a recent release and steady commit history, supporting current Python versions.

License in practice: Licensed under GPL-2.0-or-later (copyleft). Any derivative work or bundled distribution must be released under compatible terms; proprietary applications cannot incorporate this library without licensing implications.

Quickstart:

pip install librouteros

from librouteros import RouterOS

router = RouterOS(host='router.local', username='admin', password='pass')
router.connect()
result = router.query('/interface/print')

Requires Python 3.10.0 or later. A MikroTik RouterOS device with API access enabled is needed to connect to.

Verify before relying:

- Whether the library supports all RouterOS API endpoints or a specific subset of commands.
- Performance characteristics when managing large numbers of devices or high-frequency queries.
- Whether async/concurrent operations are supported or if connections are synchronous only.

## Package facts

- License: GPL-2.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 146.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mikrotik routeros api client, python routeros control, mikrotik device management, routeros network automation, mikrotik api library, network-automation, mikrotik, device-management

[View on SkillFed](https://skillfed.io/packages/librouteros) · [View on PyPI](https://pypi.org/project/librouteros/)