Metadata-Version: 2.5
Name: gufo_tower
Version: 2.0.0
Summary: A web-based control plane for managing NOC cluster topology, node assignments, and service configuration.
Project-URL: Bug Tracker, https://github.com/gufolabs/gufo_tower/issues
Project-URL: Changelog, https://github.com/gufolabs/gufo_tower/blob/master/CHANGELOG.md
Project-URL: Discord, https://discord.gg/CdZhMrWkV
Project-URL: Documentation, https://docs.gufolabs.com/gufo_tower/
Project-URL: Homepage, https://github.com/gufolabs/gufo_tower/
Project-URL: Source Code, https://github.com/gufolabs/gufo_tower/
Author: Gufo Labs
License: Copyright (C) 2015-2025, Gufo Labs (http://getnoc.com)
        All rights reserved.
        
        Redistribution and use in source and binary forms, with or without modification,
        are permitted provided that the following conditions are met:
        
        1. Redistributions of source code must retain the above copyright notice,
           this list of conditions and the following disclaimer.
        2. Redistributions in binary form must reproduce the above copyright
           notice, this list of conditions and the following disclaimer in the
           documentation and/or other materials provided with the distribution.
        3. Neither the name of NOC, nor Gufo Labs, nor the names of its contributors may be used
           to endorse or promote products derived from this software without
           specific prior written permission.
        4. A derivative product is any software, service, or system that is based on,
           modified from, or incorporates this software or its source code. It also
           includes any commercial service that depends on this software beyond simple
           usage.
        5. This software is intended exclusively for deployment, configuration, and
           management of NOC and other products explicitly authorized by Gufo Labs.
           The software may not be used as a general-purpose deployment, orchestration,
           or infrastructure management platform for unrelated products, systems, or
           services without prior written authorization from the copyright holder.
        6. The creation, modification, or distribution of derivative products, including
           adaptations of this software for use with unrelated products or services,
           requires explicit written authorization from the copyright holder.
           Any commercial use, licensing, or distribution of such derivative products
           requires prior written consent.
        
        ## DISCLAIMER
        
        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
        ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
License-File: LICENSE.md
Keywords: cluster-management,control-plane,deployment,infrastructure,network-management,noc,service-orchestration
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
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: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: ansible==2.9.26
Requires-Dist: bcrypt==5.0.0
Requires-Dist: click==8.4.2
Requires-Dist: cryptography>=44.0.0
Requires-Dist: dulwich==1.2.15
Requires-Dist: gufo-err==0.6.0
Requires-Dist: gufo-loader==2.0.1
Requires-Dist: jmespath==1.1.0
Requires-Dist: peewee==4.5.1
Requires-Dist: tornado==6.5.8
Provides-Extra: docs
Requires-Dist: mkdocs-gen-files==0.5.0; extra == 'docs'
Requires-Dist: mkdocs-literate-nav==0.6.2; extra == 'docs'
Requires-Dist: mkdocs-material==9.6.11; extra == 'docs'
Requires-Dist: mkdocs-section-index==0.3.10; extra == 'docs'
Requires-Dist: mkdocstrings[python]==0.29.1; extra == 'docs'
Provides-Extra: lint
Requires-Dist: mypy==1.19; extra == 'lint'
Requires-Dist: ruff==0.15.20; extra == 'lint'
Requires-Dist: types-peewee==4.5.0.20260907; extra == 'lint'
Requires-Dist: types-pyyaml==6.0.12.3; extra == 'lint'
Provides-Extra: playwright
Requires-Dist: playwright==1.62.0; extra == 'playwright'
Provides-Extra: test
Requires-Dist: pytest-benchmark==5.1.0; extra == 'test'
Requires-Dist: pytest-cov==7.0.0; extra == 'test'
Requires-Dist: pytest==8.4.2; extra == 'test'
Requires-Dist: pyyaml>=6.0; extra == 'test'
Description-Content-Type: text/markdown

# Gufo Tower

*A native management and deployment tool for NOC.*

[![PyPi version](https://img.shields.io/pypi/v/gufo_tower.svg)](https://pypi.python.org/pypi/gufo_tower/)
![Downloads](https://img.shields.io/pypi/dw/gufo_tower)
![Python Versions](https://img.shields.io/pypi/pyversions/gufo_tower)
[![Discord](https://img.shields.io/discord/1545437404159156304?label=Discord&logo=discord&logoColor=white)](https://discord.gg/CdZhMrWkV)
[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
![Build](https://img.shields.io/github/actions/workflow/status/gufolabs/gufo_tower/py-tests.yml?branch=master)
[![codecov](https://codecov.io/gh/gufolabs/gufo_tower/graph/badge.svg?token=ZGE0WRDS26)](https://codecov.io/gh/gufolabs/gufo_tower)
![Sponsors](https://img.shields.io/github/sponsors/gufolabs)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v0.json)](https://github.com/charliermarsh/ruff)

---

**Documentation**: https://docs.gufolabs.com/gufo_tower/

**Source Code**: https://github.com/gufolabs/gufo_tower/

---

Gufo Tower is a native management and deployment tool for [NOC](https://getnoc.com/).

Tower is designed for system administrators who manage NOC infrastructure. A NOC node can be a physical server or a virtual machine, and Tower provides a simple way to deploy, configure, upgrade, and manage NOC installations ranging from a single node to clusters of hundreds of nodes.

Tower provides centralized management of NOC nodes, making it easy to maintain consistent configurations and operate NOC infrastructure at any scale.

## Installation

To install Tower, run the installation script:

```shell
curl https://sh.gufolabs.com/tower | sh -s -- venv
```

The script creates a Python virtual environment and installs Tower into it. See the [Installation Guide](https://docs.gufolabs.com/gufo_tower/installation/index.html) for other installation methods and detailed instructions.

## Usage

After installation, open the Tower web interface at:

```text
http://<IP>:8888/
```

where `<IP>` is the IP address of the host running Tower.

Follow the instructions in the web interface to deploy and manage NOC nodes.

## On Gufo Stack

Gufo Tower is a part of the [Gufo Stack](https://docs.gufolabs.com/).

Gufo Stack is a collaborative effort led by Gufo Labs. Its goal is to create a robust and flexible set of tools for building network management software and automating routine administration tasks.

The stack extracts key technologies proven in NOC and develops them as independent packages. These components provide reusable functionality for networking, asynchronous I/O, error handling, storage, monitoring, and other common tasks.

NOC uses the resulting components as external dependencies, while other network management products can benefit from them as well.

Gufo Tower complements this ecosystem by providing a simple and reliable way to deploy and manage NOC as a native application.
