cykani-sdk

Python SDK — standalone end-to-end stealth browser automation with fingerprint evasion, human-like behavior, and autonomous browsing.

Complete browser automation in Python. Launches Chrome/Chromium directly over CDP, applies fingerprint configuration, and automates with human-like behavioral patterns. No external browser process or Node.js dependency required.

Installation

pip install cykani-sdk

Or with geoip support:

pip install cykani-sdk[geoip]

Quick Start

from cykani_sdk import strike, Maestro

# Launch Chrome directly — fully standalone, no Node.js needed
session = await strike()
await session.goto("https://example.com")
await session.close()

# Or use Maestro for multi-session control
maestro = Maestro()
session = await maestro.launch({"fingerprint": 4242})
await session.goto("https://example.com")
await session.close()

Presets

What the SDK Does (End-to-End)

cykani-sdk is a complete standalone browser automation SDK. Each preset and launch call handles the full lifecycle:

1. Launch — spawns a Chrome/Chromium process directly via subprocess
2. Configure — applies fingerprint (platform, GPU, screen, hardware concurrency), proxy, viewport, locale, timezone
3. Connect — establishes CDP WebSocket connection via cdp-use
4. Act — navigates, clicks, types with human-like behavioral patterns
5. Close — terminates the browser process and cleans up

Behavioral Engine

The Python SDK mirrors cykani-stealth's behaviors.js — same anti-detection patterns, independent implementation:

Connecting to an Existing Browser

If you already have a Chrome instance running, connect to it directly:

session = await Session.create({
    "_cdp_endpoint": "ws://127.0.0.1:9222/devtools/browser",
    "fingerprint": 4242,
})

End-to-End in Two Languages

Both SDKs provide complete end-to-end browser automation — choose whichever language fits your team:

Both share the same behavioral DNA — same Bézier curves, same typing delays, same cognitive hesitation, same micro-tremor. Pick your language and get the full experience.

Architecture

cykani-stealth/
├── src/                    # Node.js stealth engine (C++ patches, CDP)
│   └── ...                 # Full standalone browser automation
├── packages/
│   └── python/
│       └── cykani-python/  # Python SDK — complete standalone solution
│           ├── src/cykani_sdk/
│           │   ├── maestro.py      # Browser session orchestration
│           │   ├── session.py      # Standalone CDP browser session
│           │   ├── stealth/        # Behavioral engine + stealth
│           │   ├── agents/         # Autonomous navigation agents
│           │   └── utils/          # Cookies, proxy, geoip, session
│           ├── pyproject.toml
│           └── README.md
└── README.md

License

MIT