hfortix 0.5.159

Type-safe Python SDK for FortiGate firewall automation and FortiOS REST API - 1,348+ endpoints with async support and complete type safety

HFortix - Fortinet Python SDK

Meta-package for the HFortix ecosystem - Convenient installation for Fortinet automation in Python.

📦 Package Structure

This is a meta-package that provides convenient installation patterns. The actual functionality is in these packages:

Package	Repository	Description
hfortix-core	hfortix-core	Core HTTP client and shared utilities
hfortix-fortios	hfortix-fortios	FortiOS/FortiGate API client (1,300+ endpoints)

🚀 Installation Options

Everything (Recommended)

pip install hfortix[all]

Installs all current and future Fortinet product packages.

FortiOS/FortiGate Only

pip install hfortix[fortios]

Installs hfortix-core + hfortix-fortios.

Core Only

pip install hfortix

Installs only hfortix-core - the shared foundation.

Individual Packages

# Install specific packages directly
pip install hfortix-fortios  # Automatically includes hfortix-core
pip install hfortix-core     # Just the core utilities

💡 Quick Start

from hfortix_fortios import FortiOS

# Connect to FortiGate
fgt = FortiOS(
    host="192.168.1.99",
    token="your-api-token"
)

# Get firewall policies
policies = fgt.api.v2.cmdb.firewall.policy.get()

for policy in policies:
    print(f"Policy {policy.policyid}: {policy.name}")

📚 Documentation

Package	Documentation Link
hfortix-fortios	FortiOS Documentation
hfortix-core	Core API Reference

✨ Features

Comprehensive Coverage

• 1,300+ FortiOS API endpoints (CMDB, Monitor, Log, Service)
• Full type hints and IDE autocomplete
• Auto-generated from official FortiOS schemas

Developer Experience

• Pythonic API design
• Extensive inline documentation
• Type-safe request/response models

Production Ready

• Transaction support
• Error handling and retries
• Async/await support
• Rate limiting

📋 Requirements

• Python 3.10 or higher
• FortiOS 7.0+ (for FortiGate devices)

📄 License

MIT License - see LICENSE for details.

🔗 Related Projects

• hfortix-core - Core HTTP client
• hfortix-fortios - FortiOS automation

💬 Support

• 🐛 Report Issues
• 💬 Discussions

---

Author: Herman W. Jacobsen | LinkedIn | GitHub