Metadata-Version: 2.5
Name: norfab
Version: 0.26.3
Summary: Network Automations Fabric [NorFab] - communication networks automations
Project-URL: Homepage, https://github.com/norfablabs/NORFAB
Project-URL: Repository, https://github.com/norfablabs/NORFAB
Project-URL: Documentation, https://docs.norfablabs.com
Author-email: Denis Mulyalin <d.mulyalin@gmail.com>
Maintainer-email: Denis Mulyalin <d.mulyalin@gmail.com>
License-Expression: Apache-2.0
License-File: LICENCE.txt
Keywords: Automation,DevOps,Network
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Utilities
Requires-Python: <3.15,>=3.10
Requires-Dist: gitpython==3.2.1
Requires-Dist: jinja2==3.1.6
Requires-Dist: mdutils==1.8.1
Requires-Dist: orjson==3.13.0
Requires-Dist: psutil==7.2.2
Requires-Dist: pydantic==2.14.1
Requires-Dist: python-dotenv==1.2.4
Requires-Dist: pyyaml==6.0.3
Requires-Dist: pyzmq==27.2.0
Requires-Dist: tornado==6.5.10
Provides-Extra: agentservice
Requires-Dist: langchain-community==0.4.2; extra == 'agentservice'
Requires-Dist: langchain-core==1.6.12; extra == 'agentservice'
Requires-Dist: langchain-ollama==1.1.0; extra == 'agentservice'
Requires-Dist: langchain==1.4.6; extra == 'agentservice'
Requires-Dist: langgraph==1.2.16; extra == 'agentservice'
Requires-Dist: ollama==0.6.3; extra == 'agentservice'
Provides-Extra: clientagent
Requires-Dist: fastembed==0.9.0; extra == 'clientagent'
Requires-Dist: langchain-anthropic==1.7.6; extra == 'clientagent'
Requires-Dist: langchain-core==1.6.12; extra == 'clientagent'
Requires-Dist: langchain-mcp-adapters==0.3.2; extra == 'clientagent'
Requires-Dist: langchain-ollama==1.1.0; extra == 'clientagent'
Requires-Dist: langchain-openai==1.7.2; extra == 'clientagent'
Requires-Dist: langchain==1.4.6; extra == 'clientagent'
Requires-Dist: langgraph-checkpoint-sqlite==3.1.2; extra == 'clientagent'
Requires-Dist: langgraph==1.2.16; extra == 'clientagent'
Requires-Dist: qdrant-client==1.19.1; extra == 'clientagent'
Provides-Extra: docs
Requires-Dist: mkdocs-material-extensions==1.3.1; extra == 'docs'
Requires-Dist: mkdocs-material==9.7.7; extra == 'docs'
Requires-Dist: mkdocs==1.6.1; extra == 'docs'
Requires-Dist: mkdocstrings[python]==1.0.6; extra == 'docs'
Requires-Dist: pygments==2.21.0; extra == 'docs'
Requires-Dist: pymdown-extensions==11.0.1; extra == 'docs'
Provides-Extra: fakenosservice
Requires-Dist: fakenos==1.2.1; (python_version >= '3.11' and python_version < '3.13') and extra == 'fakenosservice'
Provides-Extra: fastapiservice
Requires-Dist: diskcache==5.6.3; extra == 'fastapiservice'
Requires-Dist: fastapi[standard]==0.143.3; extra == 'fastapiservice'
Requires-Dist: python-multipart==0.0.32; extra == 'fastapiservice'
Requires-Dist: uvicorn==0.54.0; extra == 'fastapiservice'
Provides-Extra: fastmcpservice
Requires-Dist: diskcache==5.6.3; extra == 'fastmcpservice'
Requires-Dist: mcp==1.30.0; extra == 'fastmcpservice'
Provides-Extra: filesharingservice
Provides-Extra: full
Requires-Dist: cerberus==1.3.8; extra == 'full'
Requires-Dist: datamodel-code-generator==0.85.0; extra == 'full'
Requires-Dist: deepdiff==9.1.0; extra == 'full'
Requires-Dist: diskcache==5.6.3; extra == 'full'
Requires-Dist: dnspython==2.8.0; extra == 'full'
Requires-Dist: fakenos==1.2.1; (python_version >= '3.11' and python_version < '3.13') and extra == 'full'
Requires-Dist: fastapi[standard]==0.143.3; extra == 'full'
Requires-Dist: fastembed==0.9.0; extra == 'full'
Requires-Dist: httpx==0.28.1; extra == 'full'
Requires-Dist: jmespath==1.1.0; extra == 'full'
Requires-Dist: langchain-anthropic==1.7.6; extra == 'full'
Requires-Dist: langchain-community==0.4.2; extra == 'full'
Requires-Dist: langchain-core==1.6.12; extra == 'full'
Requires-Dist: langchain-mcp-adapters==0.3.2; extra == 'full'
Requires-Dist: langchain-ollama==1.1.0; extra == 'full'
Requires-Dist: langchain-openai==1.7.2; extra == 'full'
Requires-Dist: langchain==1.4.6; extra == 'full'
Requires-Dist: langgraph-checkpoint-sqlite==3.1.2; extra == 'full'
Requires-Dist: langgraph==1.2.16; extra == 'full'
Requires-Dist: lxml==6.1.3; extra == 'full'
Requires-Dist: markdown-it-py==4.2.0; extra == 'full'
Requires-Dist: mcp==1.30.0; extra == 'full'
Requires-Dist: n2g==0.3.3; extra == 'full'
Requires-Dist: napalm==5.2.0; extra == 'full'
Requires-Dist: ncclient==0.7.0; extra == 'full'
Requires-Dist: netmiko==4.8.0; extra == 'full'
Requires-Dist: nornir-napalm==0.6.0; extra == 'full'
Requires-Dist: nornir-netmiko==1.0.1; extra == 'full'
Requires-Dist: nornir-salt==0.23.*; extra == 'full'
Requires-Dist: nornir-scrapli==2026.10.13; extra == 'full'
Requires-Dist: nornir==3.6.0; extra == 'full'
Requires-Dist: ntc-templates==9.3.0; extra == 'full'
Requires-Dist: ollama==0.6.3; extra == 'full'
Requires-Dist: paramiko<=4.0.0; extra == 'full'
Requires-Dist: picle==0.13.2; extra == 'full'
Requires-Dist: prompt-toolkit==3.0.53; extra == 'full'
Requires-Dist: puresnmp[crypto]==2.0.1; extra == 'full'
Requires-Dist: pydantic==2.14.1; extra == 'full'
Requires-Dist: pygnmi==0.8.15; extra == 'full'
Requires-Dist: pynetbox==7.8.0; extra == 'full'
Requires-Dist: python-multipart==0.0.32; extra == 'full'
Requires-Dist: pythonping==1.1.4; extra == 'full'
Requires-Dist: qdrant-client==1.19.1; extra == 'full'
Requires-Dist: requests==2.34.2; extra == 'full'
Requires-Dist: rich==15.0.0; extra == 'full'
Requires-Dist: robotframework==7.5; extra == 'full'
Requires-Dist: scrapli-community==2025.1.30; extra == 'full'
Requires-Dist: scrapli-netconf==2026.1.12; extra == 'full'
Requires-Dist: scrapli==2026.2.20; extra == 'full'
Requires-Dist: tabulate==0.10.0; extra == 'full'
Requires-Dist: textfsm==2.1.0; extra == 'full'
Requires-Dist: textual==8.2.8; extra == 'full'
Requires-Dist: ttp-templates>=0.6.0; extra == 'full'
Requires-Dist: ttp==0.10.1; extra == 'full'
Requires-Dist: uvicorn==0.54.0; extra == 'full'
Requires-Dist: xmltodict==1.0.4; extra == 'full'
Provides-Extra: netboxservice
Requires-Dist: datamodel-code-generator==0.85.0; extra == 'netboxservice'
Requires-Dist: deepdiff==9.1.0; extra == 'netboxservice'
Requires-Dist: diskcache==5.6.3; extra == 'netboxservice'
Requires-Dist: httpx==0.28.1; extra == 'netboxservice'
Requires-Dist: markdown-it-py==4.2.0; extra == 'netboxservice'
Requires-Dist: pynetbox==7.8.0; extra == 'netboxservice'
Requires-Dist: requests==2.34.2; extra == 'netboxservice'
Provides-Extra: nfcli
Requires-Dist: picle==0.13.2; extra == 'nfcli'
Requires-Dist: prompt-toolkit==3.0.53; extra == 'nfcli'
Requires-Dist: pydantic==2.14.1; extra == 'nfcli'
Requires-Dist: rich==15.0.0; extra == 'nfcli'
Requires-Dist: tabulate==0.10.0; extra == 'nfcli'
Provides-Extra: nornirservice
Requires-Dist: cerberus==1.3.8; extra == 'nornirservice'
Requires-Dist: dnspython==2.8.0; extra == 'nornirservice'
Requires-Dist: jmespath==1.1.0; extra == 'nornirservice'
Requires-Dist: lxml==6.1.3; extra == 'nornirservice'
Requires-Dist: n2g==0.3.3; extra == 'nornirservice'
Requires-Dist: napalm==5.2.0; extra == 'nornirservice'
Requires-Dist: ncclient==0.7.0; extra == 'nornirservice'
Requires-Dist: netmiko==4.8.0; extra == 'nornirservice'
Requires-Dist: nornir-napalm==0.6.0; extra == 'nornirservice'
Requires-Dist: nornir-netmiko==1.0.1; extra == 'nornirservice'
Requires-Dist: nornir-salt==0.23.*; extra == 'nornirservice'
Requires-Dist: nornir-scrapli==2026.10.13; extra == 'nornirservice'
Requires-Dist: nornir==3.6.0; extra == 'nornirservice'
Requires-Dist: ntc-templates==9.3.0; extra == 'nornirservice'
Requires-Dist: paramiko<=4.0.0; extra == 'nornirservice'
Requires-Dist: puresnmp[crypto]==2.0.1; extra == 'nornirservice'
Requires-Dist: pydantic==2.14.1; extra == 'nornirservice'
Requires-Dist: pygnmi==0.8.15; extra == 'nornirservice'
Requires-Dist: pythonping==1.1.4; extra == 'nornirservice'
Requires-Dist: requests==2.34.2; extra == 'nornirservice'
Requires-Dist: scrapli-community==2025.1.30; extra == 'nornirservice'
Requires-Dist: scrapli-netconf==2026.1.12; extra == 'nornirservice'
Requires-Dist: scrapli==2026.2.20; extra == 'nornirservice'
Requires-Dist: tabulate==0.10.0; extra == 'nornirservice'
Requires-Dist: textfsm==2.1.0; extra == 'nornirservice'
Requires-Dist: ttp-templates>=0.6.0; extra == 'nornirservice'
Requires-Dist: ttp==0.10.1; extra == 'nornirservice'
Requires-Dist: xmltodict==1.0.4; extra == 'nornirservice'
Provides-Extra: robot
Requires-Dist: robotframework==7.5; extra == 'robot'
Provides-Extra: tui
Requires-Dist: textual==8.2.8; extra == 'tui'
Description-Content-Type: text/markdown

[![Downloads][pepy-downloads-badge]][pepy-downloads-link]
[![PyPI][pypi-latest-release-badge]][pypi-latest-release-link]
[![PyPI versions][pypi-pyversion-badge]][pypi-pyversion-link]
[![GitHub Discussion][github-discussions-badge]][github-discussions-link]
[![Code style: black][black-badge]][black-link]
[![uv][uv-badge]][uv-link]
[![Ruff][ruff-badge]][ruff-link]
[![Spec Kit][speckit-badge]][speckit-link]
[![Documentation][docs-badge]][docs-link]
[![pytest][pytest-badge]][pytest-link]
[![Docker Hub][docker-badge]][docker-link]
[![Sponsor][sponsor-badge]][sponsor-link]

![logo](docs/images/logo.jpg)

# Network Automations Fabric - NORFAB

---
**Documentation**: [NorFab Docs](https://docs.norfablabs.com)

**Contact**: [Networktocode Slack](https://app.slack.com/client/T09LQ7E9E/C0894SVH7BQ) | [NetDev Community Slack](https://netdev-community.slack.com/archives/C08MAVA3492) | [GitHub Discussions](https://github.com/norfablabs/NORFAB/discussions)

---

NORFAB is a tool for extreme network automations.

# The IDEA 💡

Most of the software to manage networks falls into one of the two categories: 

- heavyweight platforms running on dedicated infrastructure
- lightweight scripts or tools developed and run locally

NORFAB goal is to be both - software you can run equally well on your laptop or on a 
server, centralized or fully distributed, lightweight and feature reach. Capable of 
doing any use cases without the need to throw gazillions of dollars and man hours at 
it. Always ready to serve the purpose of unlocking engineers superpowers managing
modern network and making their life better.

# Key Features 🚀

- Run Anywhere - Windows, MAC, Linux, in a container or VM, on-prem or in cloud, centralized or distributed
- Extend Anything - extendability is in the core of NORFAB
- Integrate with Everything - Python API, REST API, CLI northbound interfaces
- Manage Anything - develop your own services or use built-in to manage your network infrastructure
- Model and data driven - Pydantic models for API, validation and documentation
- Automate Anything - we mean it, sky is the limit on what you can do with NORFAB automating your networks

# Architecture 🏦

**TLDR** Service-Oriented Architecture (SOA)

Clients communicate with broker to run the jobs, broker distributes jobs across workers comprising the service.

# History 📜

NORFAB is a successor of Salt-Nornir SaltStack proxy minion aiming 
to surpass its limitations.

# Use Cases 🔧

**Collect show commands**
![collect show commands](docs/images/nornir_cli_demo.gif)

**Configure network devices**
![configure network devices](docs/images/nornir_cfg_demo.gif)

**Test your network**
![test network](docs/images/nornir_test_demo.gif)

**Diagram your network**
![diagram your network](docs/images/nornir_diagram_demo_layer3.gif)

**And many more** [read documentation](https://dmulyalin.github.io/NORFAB/)

[github-discussions-link]:     https://github.com/norfablabs/NORFAB/discussions
[github-discussions-badge]:    https://img.shields.io/static/v1?label=Discussions&message=Ask&color=blue&logo=github
[black-badge]:                 https://img.shields.io/badge/code%20style-black-000000.svg
[black-link]:                  https://github.com/psf/black
[pypi-pyversion-link]:         https://pypi.python.org/pypi/norfab/
[pypi-pyversion-badge]:        https://img.shields.io/pypi/pyversions/norfab.svg
[pepy-downloads-link]:         https://pepy.tech/project/norfab
[pepy-downloads-badge]:        https://pepy.tech/badge/norfab
[pypi-latest-release-badge]:   https://img.shields.io/pypi/v/norfab.svg
[pypi-latest-release-link]:    https://pypi.python.org/pypi/norfab
[uv-badge]:                   https://img.shields.io/badge/managed%20with-uv-DE5FE9?logo=uv
[uv-link]:                    https://docs.astral.sh/uv/
[ruff-badge]:                 https://img.shields.io/badge/linting-Ruff-D7FF64?logo=ruff
[ruff-link]:                  https://docs.astral.sh/ruff/
[speckit-badge]:              https://img.shields.io/badge/spec--driven-Spec%20Kit-blue
[speckit-link]:               https://github.com/github/spec-kit

[docs-badge]:                 https://img.shields.io/badge/docs-NorFab-blue?logo=readthedocs
[docs-link]:                  https://docs.norfablabs.com

[pytest-badge]:               https://img.shields.io/badge/tested%20with-pytest-0A9EDC?logo=pytest
[pytest-link]:                https://docs.pytest.org/
[docker-badge]:               https://img.shields.io/docker/pulls/dmulyalin/norfab?logo=docker&label=Docker%20Hub%20pulls
[docker-link]:                https://hub.docker.com/r/dmulyalin/norfab/tags

[sponsor-badge]:              https://img.shields.io/badge/Sponsor-NorFab-EA4AAA?logo=githubsponsors
[sponsor-link]:               https://github.com/sponsors/norfablabs
