CR: netapi Commercialization Roadmap

Change Summary

Change ID

CR-2026-03-25-netapi-commercialization

Type

Product / Commercial

Priority

P1 - High

Status

Planning

Requested

2026-03-25

Completed

TBD

Owner

Evan Rosado

Background

netapi has grown from a personal automation tool to a comprehensive network automation library supporting 18 vendors. Following the security hardening work (CR-2026-03-25-netapi-security-hardening), a commercial viability assessment was conducted to determine readiness for monetization.

Assessment Results

Commercial Readiness Score: 3.5/10

The codebase has excellent architecture but lacks the supporting infrastructure required for commercial release.

Current State Analysis

Strengths

Area Details

Architecture

Clean atomic design: primitives → protocols → capabilities → vendors → workflows

Code Quality

Unified exception hierarchy, pydantic models, type hints throughout

Vendor Coverage

18 vendors: ISE (5 APIs), WLC, IOS-XE, FMC, pfSense, Synology, Infoblox, Keycloak, GitHub, GitLab, Gitea, KVM, Vault, Wazuh, Cloudflare, Monad

ISE Depth

Industry-leading: ERS, MnT, DataConnect (SQL), pxGrid (WebSocket), OpenAPI

Security

v0.4.0 patched all Dependabot vulnerabilities

Critical Gaps

Gap Severity Current Target

Test Coverage

CRITICAL

193 lines

2,000+ lines (70% coverage)

API Documentation

CRITICAL

None

Full Sphinx/MkDocs reference

PyPI Publication

CRITICAL

Not published

pip install netapi

Version

HIGH

0.1.0

1.0.0 (semver)

Examples

HIGH

Scattered

Dedicated cookbook repo

CHANGELOG

MEDIUM

None

keepachangelog format

Market Positioning

Target Niche: "NetAPI for Cisco ISE"

Rather than competing broadly with Ansible, Napalm, or Netmiko, position netapi as THE Cisco ISE automation library.

Competitive Advantages

Feature Competitive Position

DataConnect SQL

Only Python library with full DataConnect support

5 ISE APIs

Most comprehensive ISE coverage (ERS, MnT, DataConnect, pxGrid, OpenAPI)

pxGrid WebSocket

Real-time session monitoring, CoA, health metrics

Exception Hierarchy

Vendor-aware errors enable clean error handling

Type Safety

Full pydantic models with IDE autocompletion

Target Customers

  1. Enterprise ISE Admins - Automate endpoint management, policy creation, reporting

  2. MSPs/Integrators - Multi-tenant ISE management

  3. DevNet Developers - Building ISE integrations

  4. Security Teams - SIEM integration, compliance reporting

Implementation Plan

Phase 1: Test Infrastructure

Priority: P0 Status: Not Started

Deliverables

  • pytest configuration with fixtures

  • Unit tests for ISE ERS client

  • Unit tests for ISE MnT client

  • Unit tests for ISE DataConnect client

  • Mock server for integration tests

  • GitHub Actions CI/CD pipeline

  • Coverage reporting (codecov)

Acceptance Criteria

  • 70%+ code coverage

  • All PRs require passing tests

  • Coverage badge on README

Phase 2: Documentation Site

Priority: P0 Status: Not Started

Deliverables

  • Sphinx or MkDocs setup

  • Auto-generated API reference

  • Quick start guide

  • ISE automation cookbook

  • Examples repository (netapi-examples)

  • GitHub Pages deployment

Acceptance Criteria

  • Complete API reference for all public classes

  • Working quick start in <5 minutes

  • 10+ real-world examples

Phase 3: PyPI Distribution

Priority: P1 Status: Not Started

Deliverables

  • Version bump strategy (0.5.0 → 1.0.0)

  • PyPI account setup

  • pyproject.toml metadata complete

  • CHANGELOG.md (keepachangelog format)

  • Release automation (GitHub Actions)

  • README with badges

Acceptance Criteria

  • pip install netapi works

  • Semantic versioning enforced

  • Release notes for each version

Phase 4: Community & Marketing

Priority: P2 Status: Not Started

Deliverables

  • GitHub Discussions enabled

  • CONTRIBUTING.md

  • Issue templates

  • DevNet code exchange listing

  • Blog post: "Automating Cisco ISE with netapi"

  • Conference talk proposal (Cisco Live, DevNet Create)

Acceptance Criteria

  • 50+ GitHub stars

  • 100+ PyPI downloads/month

  • 5+ community contributors

Success Metrics

Phase Metric Target Timeline

Phase 1

Test coverage

70%+

TBD

Phase 2

Doc page views

500/month

TBD

Phase 3

PyPI downloads

100/month

TBD

Phase 4

GitHub stars

50+

TBD

Revenue Model (Future)

Open Core Strategy

Free (Apache-2.0): * All current functionality * CLI interface * All ISE APIs

Commercial (Paid): * Enterprise support contracts * Custom integrations * Training/consulting * Priority feature requests

Risk Analysis

Risk Probability Impact Mitigation

Low adoption

Medium

High

Focus on ISE niche, DevNet marketing

Competitor response

Low

Medium

First-mover advantage, depth over breadth

Cisco API changes

Medium

Medium

Version pinning, deprecation warnings

Burnout (solo dev)

Medium

High

Phase work, celebrate milestones

Related Documentation

Changelog

Date Author Change

2026-03-25

Evan Rosado

Initial CR created with 4-phase commercialization plan