bridgic

<p align="center">
    <picture>
        <img src="https://raw.githubusercontent.com/bitsky-tech/bridgic/refs/heads/main/docs/docs/assets/logo_white_bg.svg" alt="Bridgic" width="500">
    </picture>
</p>

---

[![License MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/)
[![PyPI Version](https://img.shields.io/pypi/v/bridgic.svg)](https://pypi.org/search/?q=bridgic)
[![PyPI Downloads](https://img.shields.io/pypi/dm/bridgic.svg)](https://pypi.org/search/?q=bridgic)


**Bridgic** is the next-generation agent development framework for building intelligent systems.

By redefining the boundary between workflows and agents, Bridgic introduces a unified orchestration and runtime model which enables developers to seamlessly transition between predictable workflows and autonomous, creative agents within one system.

> ✨ The name "**Bridgic**" embodies our core philosophy — **"Bridging Logic and Magic"**, where:
>   - *Logic* represents deterministic and predictable execution flows, forming the foundation of reliable systems.
>   - *Magic* refers to the autonomous parts that can make dynamic decisions and solve problems creatively.

<div align="center">

```mermaid
graph
    subgraph " "
        A["Deterministic Workflows<br/>(Logic)"]
        B["Autonomous Agents<br/>(Magic)"]
    end
    
    A ---> B
    B ---> A
    
    style A fill:#f9f9f9,stroke:#333,stroke-width:2px
    style B fill:#f9f9f9,stroke:#333,stroke-width:2px
```

</div>


## 📦 Installation

Bridgic requires Python 3.9 or newer.

### Using pip

```bash
pip install bridgic
python -c "from bridgic.core import __version__; print(f'Bridgic version: {__version__}')"
```

### Using uv

```bash
uv add bridgic
uv run python -c "from bridgic.core import __version__; print(f'Bridgic version: {__version__}')"
```


## 🔗 Key Features

### 🌀 Core Runtime Engine

* **Unified DDG