Skip to main content

Noctyra

Noctyra Demo

PyPI version Python versions Downloads License

Noctyra is an AST-based framework designed for code transformation and deobfuscation. It provides a modular pipeline to analyze and simplify Python source code by resolving complex expressions and logic.

Overview

The project aims to provide a flexible environment for processing Python's Abstract Syntax Tree. By employing a sequence of pluggable transformers, Noctyra can:

  • Simplify nested logic and conditions.
  • Resolve static values and common encoding patterns.
  • Unroll dynamic execution blocks into readable code.
  • Optimize and clean up obfuscated constructs.

Getting Started

Prerequisites

Ensure you have uv installed for dependency management.

uv sync

Running the Pipeline

To process a target script, use the following command:

python main.py <input_file> [options]

Options:

  • file: Path to the input Python file (required).
  • --output: File name for the transformed code (default: out.py).
  • --iterations: Set a fixed number of transformation passes (default: 0 for auto-detect).
  • --max-iterations: Limit the passes in auto mode (default: 100).
  • --debug: Enable verbose logging for debugging transformations. (look sick)

Development

This project uses uv for dependency management and a Makefile for common tasks.

Setup

uv sync --all-extras --dev

Quality Control

Before submitting a PR or pushing changes, ensure all checks pass:

  • Run Tests: make test
  • Lint & Format: make format
  • Type Check: make typecheck

(Windows users: These commands work automatically via make.bat.)

CI/CD

Automated checks are performed on every push via GitHub Actions, including linting with Ruff, type checking with Mypy, and unit testing with Pytest.

Security Notice

Noctyra includes an internal evaluation engine with basic resource limits. However, when dealing with untrusted code, it is highly recommended to run the pipeline within an isolated environment (such as a container or sandbox) to prevent potential side effects or resource exhaustion.


Metadata

Release files for noctyra 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for noctyra 0.4.0
File Size Uploaded Provenance Actions
noctyra-0.4.0.tar.gz 492.7 kB Without provenance Details for noctyra-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for noctyra 0.4.0
File Interpreter ABI Platform Actions
noctyra-0.4.0-py3-none-any.whl Python 3 none any Details for noctyra-0.4.0-py3-none-any.whl

Total release size: 513.7 kB

Release files / noctyra-0.4.0.tar.gz

Download URL noctyra-0.4.0.tar.gz
Size 492.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a66944024ebacd2abbf0735a06bdfec79dd76350f8b917272497d80a12914ef5
BLAKE2b-256 checksum
How to use checksums
b2be2baa997406a0b9e5e550154c4580e0bcccdad2be0617bb32da3440bb2a5c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / noctyra-0.4.0-py3-none-any.whl

Download URL noctyra-0.4.0-py3-none-any.whl
Size 21.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
056e8cd0e395ad8737c40460af8794300064d02ff74e3f34faded2293ac46926
BLAKE2b-256 checksum
How to use checksums
f26965abfed505d5bd9654db00f44ccb46500a481a9eb5cc633c5a29acf532dc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for noctyra 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page