Metadata-Version: 2.4
Name: pykoppu
Version: 0.2.30a0
Summary: SDK for KOPPU (K-dimensional Organoid Probabilistic Processing Unit)
Home-page: https://koppu.io
Author: KOPPU Team
Author-email: KOPPU Team <contact@koppu.io>
License: MIT
Project-URL: Homepage, https://koppu.io
Project-URL: Repository, https://github.com/koppu/pykoppu
Project-URL: Bug Tracker, https://github.com/koppu/pykoppu/issues
Keywords: organoid computing,neuromorphic,optimization,pubo,brian2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: brian2>=2.5
Requires-Dist: networkx
Requires-Dist: numpy
Requires-Dist: scipy
Provides-Extra: doc
Requires-Dist: mkdocs-material; extra == "doc"
Requires-Dist: mkdocstrings[python]; extra == "doc"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

<p align="center">
  <img src="koppu.png" alt="KOPPU Logo" width="400"/>
</p>

<p align="center">
  The world's first full-stack bio-hybrid computing architecture for massive parallel solving of k-PUBO optimization problems.
</p>

<p align="center">
  <a href="https://koppu.io/docs"><strong>Explore the Docs »</strong></a>
  <br />
  <br />
  <a href="https://koppu.io">Koppu Cloud (OaaS)</a>
  ·
  <a href="#quick-start">Quick Start</a>
  ·
  <a href="#architecture">Architecture</a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python Version">
  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
  <img src="https://img.shields.io/badge/platform-OaaS-purple.svg" alt="Organoid as a Service">
</p>

---

## 🧠 Overview

**KOPPU** represents a paradigm shift in non-von Neumann computing. Situated as a strategic "Middle Path" between the energy inefficiency of classical silicon bit-flipping and the decoherence fragility of quantum qubits, KOPPU leverages the intrinsic stochasticity of biological neural networks to solve NP-hard problems.

At the heart of the system is the **OPU (Organoid Processing Unit)**, a bio-processor composed of human cerebral organoids interfaced via High-Density Multi-Electrode Arrays (HD-MEA).

By manipulating **pobits** (Probabilistic Organoid Bits), the system effectively searches complex energy landscapes to minimize **k-PUBO** (Polynomial Unconstrained Binary Optimization) Hamiltonians, offering massive parallelism at physiological temperatures.

## ✨ Key Features

*   **Bio-Hybrid Hardware:** Uses living biological tissue as the primary computational substrate.
*   **Native k-PUBO Solver:** Solves high-order polynomial optimization problems without the overhead of reduction to quadratic forms.
*   **Full-Stack Ecosystem:** From the `pykoppu` Python SDK down to the **BioASM** machine code and the **OOS** (Organoid Operating System).
*   **OaaS (Organoid as a Service):** Access real biological hardware or digital twins via the **koppu.io** cloud platform.
*   **Energy Efficient:** Computes using metabolic energy, orders of magnitude more efficient than GPUs for specific stochastic tasks.

## 🏗️ System Architecture

The KOPPU ecosystem consists of several abstraction layers:

1.  **Pobit:** The fundamental unit of information. A stochastic binary unit implemented by neuronal ensembles.
2.  **OPU:** The physical cartridge containing the organoid and the MEA interface.
3.  **BioASM:** The low-level instruction set architecture (ISA) used to control the OPU (e.g., `ALC`, `LDJ`, `RUN`).
4.  **OOS:** The embedded operating system managing the real-time feedback loop.
5.  **pykoppu:** The high-level client library for Python.

## 🚀 Quick Start

### Installation

```bash
pip install pykoppu
