Metadata-Version: 2.4
Name: fuse-io
Version: 0.1.94
Summary: Fuse - Workflow automation. A powerful local-first automation platform with visual builder, AI integration, and extensive node library.
Author-email: Bibek Timilsina <bibektimilsina@example.com>
License: MIT
Project-URL: Homepage, https://github.com/fuse-io/fuse
Project-URL: Documentation, https://github.com/fuse-io/fuse#readme
Project-URL: Source Code, https://github.com/fuse-io/fuse
Project-URL: Bug Tracker, https://github.com/fuse-io/fuse/issues
Keywords: automation,workflow,no-code,low-code,fastapi,ai,integration
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Office/Business :: Scheduling
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Framework :: FastAPI
Requires-Python: <4.0,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: alembic>=1.16.5
Requires-Dist: anthropic>=0.75.0
Requires-Dist: argon2-cffi>=23.1.0
Requires-Dist: celery>=5.6.0
Requires-Dist: click>=8.1.0
Requires-Dist: email-validator>=2.3.0
Requires-Dist: emails>=0.6
Requires-Dist: fastapi>=0.116.1
Requires-Dist: feedparser>=6.0.11
Requires-Dist: google-genai>=0.2.2
Requires-Dist: gunicorn>=23.0.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: jinja2>=3.1.6
Requires-Dist: jsonschema>=4.25.1
Requires-Dist: openai>=2.8.1
Requires-Dist: passlib>=1.7.4
Requires-Dist: pydantic>=2.11.7
Requires-Dist: pydantic-settings>=2.10.1
Requires-Dist: pyjwt>=2.10.1
Requires-Dist: python-multipart>=0.0.20
Requires-Dist: redis>=7.1.0
Requires-Dist: rich>=14.2.0
Requires-Dist: sqlmodel>=0.0.24
Requires-Dist: tenacity>=9.1.2
Requires-Dist: uvicorn[standard]>=0.35.0
Provides-Extra: dev
Requires-Dist: coverage>=7.10.6; extra == "dev"
Requires-Dist: mypy>=1.17.1; extra == "dev"
Requires-Dist: pre-commit>=4.3.0; extra == "dev"
Requires-Dist: pytest>=8.4.2; extra == "dev"
Requires-Dist: ruff>=0.12.12; extra == "dev"
Requires-Dist: types-passlib>=1.7.7.20250602; extra == "dev"
Dynamic: license-file

# 🚀 Fuse - The AI-Native Automation Engine

[![PyPI version](https://badge.fury.io/py/fuse-io.svg)](https://badge.fury.io/py/fuse-io)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Fuse** is a powerful **local-first** workflow automation platform designed from the ground up for the agentic era. Build complex, intelligent automations with a beautiful visual builder, modular node system, and deep AI integration.

> **"Bridging the gap between AI capabilities and real-world processes."** ⚡

---

## 🌟 Why Fuse?

Unlike traditional automation tools, Fuse is built with an **AI-first** philosophy. It doesn't just "support" AI; it treats LLMs and Agents as first-class citizens of your workflow ecosystem.

- **🔒 Local-First & Privacy-Centric**: Run your workflows locally. Your data, your rules.
- **🤖 Agentic Orchestration**: Native support for autonomous AI Agents that can plan, execute, and iterate.
- **🔌 Infinite Extensibility**: A modular architecture where every node and plugin is an isolated, versioned package.
- **🌌 Antigravity Support**: Dynamic proxying to unlock pro-tier models (Claude 3.5/4.5, Gemini Pro) via local entitlements.

---

## ✨ Features

### 🎨 Visual Workflow Builder
- **Intuitive Canvas**: Drag-and-drop interface powered by **React Flow**.
- **Real-time Observability**: Live execution logs streamed directly to the UI via WebSockets.
- **Advanced Logic**: Built-in support for parallel execution, loops, and conditional branching.
- **40+ Pre-built Nodes**: A massive library of triggers and actions ready to use.

### 🤖 AI Native Capabilities
- **Multi-LLM Support**: Seamless switching between OpenAI, Anthropic, and Google AI.
- **AI-Assisted Creation**: Describe your goal in natural language and watch Fuse build the workflow for you.
- **Cost Monitoring**: Automatic tracking of token usage and execution costs.
- **Human-in-the-loop**: Pause execution for manual approval or input.

### 🏗️ Modular Ecosystem
- **`node_packages/`**: A standard for defining workflow nodes with isolated requirements and backend logic.
- **`plugin_packages/`**: Extend the core platform with custom services, UI panels, and background processes.

---

## 📦 Getting Started

The recommended way to install and run Fuse is using **[uv](https://github.com/astral-sh/uv)** for high-performance Python management.

### 1. Installation

```bash
uv pip install fuse-io
```

### 2. Initialize Project

```bash
# Set up your environment and initial database
fuse init
```

### 3. Launch the Engine

```bash
# Start the backend server and frontend dashbard
fuse start
```

Your dashboard will be available at **`http://localhost:5678`** 🚀

---

## 🏗️ Architecture

Fuse uses a decoupled, three-tier architecture designed for speed and reliability.

```text
┌──────────────────────────────────────────┐
│          Dashboard (Next.js)             │
│   - Visual Builder | Real-time Logs      │
│   - Node Management | Credentials        │
└───────────────────┬──────────────────────┘
                    │ REST + WebSockets
┌───────────────────▼──────────────────────┐
│          Core Engine (FastAPI)           │
│   - JWT Auth | Workflow Orchestrator     │
│   - Plugin Discovery | Node Execution     │
└─────────┬────────────────────────┬───────┘
          │                        │
┌─────────▼─────────┐    ┌─────────▼────────┐
│    SQLModel DB    │    │  Redis + Celery  │
│  (Workflows/Logs) │    │  (Async tasks)   │
└───────────────────┘    └──────────────────┘
```

---

## � The Antigravity Plugin

The **Antigravity** plugin is Fuse's "secret sauce." It allows you to use high-tier models (like Claude 3.5 Sonnet or Gemini 1.5 Pro) using your existing Google AI entitlements by proxying requests through your local machine.

- **Unlock Zero-Cost Pro Tier**: Leverages free-tier or paid entitlements directly through your browser's authenticated session.
- **Local CLIProxyAPI**: A lightweight local server that bridges standard OpenAI/Anthropic API calls to the Antigravity proxy.

---

## 🛠️ Development Setup

If you want to contribute to the core engine or build custom nodes:

### Prerequisites
- Python 3.10+
- Node.js 18+
- [uv](https://github.com/astral-sh/uv)

### Clone and Install
```bash
git clone https://github.com/fuse-io/fuse.git
cd fuse

# Backend Setup
cd fuse_backend
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

# Frontend Setup
cd ../fuse_frontend
npm install
npm run dev
```

---

## 🤝 Contributing

We love contributions! Whether it's a new node, a bug fix, or a feature request, feel free to open a PR.

1. Fork the repo.
2. Create your feature branch (`git checkout -b feature/AmazingFeature`).
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`).
4. Push to the branch (`git push origin feature/AmazingFeature`).
5. Open a Pull Request.

---

## 📄 License

Distributed under the MIT License. See `LICENSE` for more information.

---

**Built with ⚡ by [Bibek Timilsina](https://github.com/bibektimilsina)**
*Keep your workflows in constant fuse* 🌊
