Skip to main content

PyTorch-native randomized optimization algorithms.

Project description

pyperch

PyPI Python Versions License: MIT Code Style: Black Linter: Ruff CircleCI

A lightweight library for neural network weight optimization using randomized search algorithms built directly on top of PyTorch. Pyperch is a research and teaching-oriented library for training neural networks using randomized optimization methods (RHC, SA, GA), gradient-based methods, and hybrid combinations.

PyPerch also includes optional hyperparameter search utilities layered on top of the standalone optimizers.

Installation

Install from PyPI:

pip install pyperch

or with Poetry:

poetry add pyperch

Development Setup

Clone the repository:

git clone https://github.com/jlm429/pyperch.git
cd pyperch

Install development dependencies:

poetry install

Examples

The fastest way to get started with PyPerch is to explore the examples.

See:

Examples

Optuna Search


Documentation

See:

General Usage Guide

Search Usage Guide


Contributing

Pull requests are welcome.

Setup:

poetry install

Format code:

poetry run ruff format .

Lint code:

poetry run ruff check .

Typical workflow:

  1. Fork the repository
  2. Create a feature branch
  3. Commit changes
  4. Open a pull request

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyperch-0.3.1.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyperch-0.3.1-py3-none-any.whl (11.9 kB view details)

Uploaded Python 3

File details

Details for the file pyperch-0.3.1.tar.gz.

File metadata

  • Download URL: pyperch-0.3.1.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.1 CPython/3.13.9 Darwin/25.5.0

File hashes

Hashes for pyperch-0.3.1.tar.gz
Algorithm Hash digest
SHA256 a6adf9a2725f4b54f592090243011500aafa50f13f3d4027673b926d2adc518c
MD5 8a0388a9fb8fd24c3e3f1c790dc4be09
BLAKE2b-256 3df5f106cdef98a6df55f9626e13cab5e777719bd16ea8d90a284e9a1aae79cc

See more details on using hashes here.

File details

Details for the file pyperch-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: pyperch-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 11.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.1 CPython/3.13.9 Darwin/25.5.0

File hashes

Hashes for pyperch-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7aa3bc18dfed656c172257f6d34e9b5e2aeac36d4ba99476c4ac3f30bf977625
MD5 b61af63ee6236f2c2c0dba812fd7fc28
BLAKE2b-256 db11e7d1c345cdffb78a4360ba0143979846805a95bb9d5db97531a26c873508

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page