Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

CoSy

CoSy logo
Package PyPI - Version PyPI - Python Version
License License
Package CI - Test CD - Release CoSy
Docs Docs - Release Docs - Checks
Coverage codecov codecov
Traits Hatch project Checked with mypy Checked with Ruff

CoSy enables synthesis of arbitrary artifacts from individual modular components. It efficiently handles specification and constraints of these modular components, describing how they connect and which performance criteria need to be satisfied.

APIs

CoSy can be used in two different ways.

  • Using the Synthesizer. This enables using all features but is more complicated to use.
  • Using the Maestro. This enables using less features, but is easy to use.

The Synthesizer is the recommended way for "power-users" to interact with CoSy. Publications that primarily focus on type-theoretic aspects usually use it.

The Maesto is the cute creature playing with building blocks (modular components) on the logo. This gifted architect is incredible at connecting these to satisfy any target a user may query for. The Maestro API is intended to be easy to use, but the trade-off is lower flexibility.

For most technological applications of combinatory synthesis to other fields, e.g. synthesizing physical structures, the Maestro is sufficient.

Examples

  • For a simple example for a theoretically minded computer scientist, see: Fibonacci
  • For a simple example for a practically minded engineer, see: Robot Arm (WIP)

While the examples above use Maestro, the following example uses the Synthesizer:

  • For a simple example on the usage of evolutionary algorithms for searching the synthesized solution spaces, see: Symbolic Regression

Installation

Installation is as simple as running:

pip install --pre combinatory-synthesizer

Since CoSy is still in pre-release state, PyPi distributions are likely to be outdated most of the time.

If you want to stay up to date with a nightly build:

pip install https://github.com/tudo-seal/cosy/releases/download/nightly/combinatory_synthesizer-nightly.tar.gz

CoSy itself has no dependencies at all, so it will play nice with any pre-existing projects.

Documentation

This README is intentionally left brief.
Please head over to the documentation to get started.

License

CoSy is distributed under the terms of the Apache-2.0 license.

Download files

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

Source Distribution

combinatory_synthesizer-0.0.1.dev33.tar.gz (117.2 kB view details)

Uploaded Source

Built Distribution

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

combinatory_synthesizer-0.0.1.dev33-py3-none-any.whl (71.6 kB view details)

Uploaded Python 3

File details

Details for the file combinatory_synthesizer-0.0.1.dev33.tar.gz.

File metadata

File hashes

Hashes for combinatory_synthesizer-0.0.1.dev33.tar.gz
Algorithm Hash digest
SHA256 81b6a270bb6c166582ee09a0b2a5ae68c03122dbf7f72949d97e60ef0e4cb84a
MD5 aa13f9ef0902053fb36b2e8b46b3bddb
BLAKE2b-256 26da7366f4de84e8bc1c97e48101544b41356c7b1af99c014f44f0d259065ef2

See more details on using hashes here.

Provenance

The following attestation bundles were made for combinatory_synthesizer-0.0.1.dev33.tar.gz:

Publisher: pre-release.yml on tudo-seal/cosy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file combinatory_synthesizer-0.0.1.dev33-py3-none-any.whl.

File metadata

File hashes

Hashes for combinatory_synthesizer-0.0.1.dev33-py3-none-any.whl
Algorithm Hash digest
SHA256 6b8436592085816890c42230499b84fe9aed9310e49602c6637a813e005f6947
MD5 aed9ec945412ca7dae2e99af7f71e53e
BLAKE2b-256 540ac387e9dda9805fa875dbcc53a3f35e479f60389fbde51b4815cf68259369

See more details on using hashes here.

Provenance

The following attestation bundles were made for combinatory_synthesizer-0.0.1.dev33-py3-none-any.whl:

Publisher: pre-release.yml on tudo-seal/cosy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.
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