gseldon/python-gost-engine repository overview

⁠Python with GOST Cryptographic Engine Support

A Docker image and Python library for working with websites and services that use Russian cryptographic standards GOST (GOST R 34.10-2012, GOST R 34.11-2012) in SSL/TLS connections.

⁠Overview

This project provides a ready-to-use solution for developers who need to work with Russian services that support only GOST encryption. It includes a Docker image with pre-installed Python and the gost_http library for easy integration into existing projects.

⁠Features

• ✅ Full support for Russian GOST cryptographic standards
• ✅ Automatic connection method selection (requests/pyOpenSSL/curl)
• ✅ Works with GOST-only cipher suite websites
• ✅ Works with mixed websites (GOST + standard cipher suites)
• ✅ Simple API compatible with requests
• ✅ Pre-configured Docker image environment
• ✅ Python library for integration into existing projects

⁠Supported GOST Algorithms

• Signature: GOST R 34.10-2012 (256/512 bit)
• Hash: GOST R 34.11-2012 (Streebog 256/512 bit)
• Encryption: GOST 28147-89, Kuznyechik, Magma
• Key Exchange: VKO GOST R 34.10-2012

⁠Quick Start

⁠Pull the Image

docker pull gseldon/python-gost-engine:latest

Or use a specific version:

docker pull gseldon/python-gost-engine:3.12-alpine-v0.1.0

The gost_http library provides a simple interface for making HTTPS requests to GOST-enabled websites. For detailed examples and usage instructions, see the GitHub repository⁠.

The library supports multiple usage patterns:

• Drop-in replacement for requests module
• Standalone functions for HTTP methods
• Custom GOSTHTTPClient class

⁠Image Tags

• latest - Latest stable release
• {PYTHON_VERSION}-alpine-{RELEASE_TAG} - Specific version (e.g., 3.12-alpine-v0.1.0)

⁠Components

• Python: Configurable version (default: 3.12)
• Base Image: Alpine Linux
• GOST Engine: gost-engine⁠ - Reference implementation of GOST cryptographic algorithms for OpenSSL
• Pre-installed packages: requests, urllib3, pyOpenSSL, cryptography

⁠Documentation and Examples

For complete documentation, code examples, and usage patterns, visit the GitHub repository⁠.

⁠License

This project follows the licensing of its components:

• GOST Engine: Apache 2.0 / OpenSSL License
• Python: PSF License
• Alpine Linux: Various open-source licenses