Noctyra
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:0for 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.