graphbit 0.5.0__tar.gz

graphbit-0.5.0/LICENSE.md

@@ -0,0 +1,92 @@
+# GRAPHBIT FRAMEWORK LICENSE
+
+Copyright © 2023–2025 InfinitiBit GmbH. All rights reserved.
+
+By downloading, installing, or using the GraphBit framework (the “framework”), you agree to this License.
+
+## 1. Parties
+
+Licensor: **InfinitiBit GmbH**, Heiglhofstr. 90, 81377 Munich, Germany.
+Licensee: The individual or legal entity using the framework.
+
+## 2. Definitions
+
+* **framework**: The complete source code and related materials provided by Licensor, including the Rust core, Python wrapper, scripts, libraries, and configuration described in the GraphBit documentation.
+* **Outputs**: Results, data, and artifacts generated by the framework.
+* **Enterprise Use**: Any use not expressly permitted under Model A or Model B, including but not limited to: (i) use by organizations with more than ten (10) employees or more than ten (10) active users, (ii) embedding in commercial products/services, or (iii) offering the framework or derivative works as a hosted service (e.g., API, SaaS, managed platform).
+* **Active Users**: All persons using the framework, including employees, contractors, and/or end users accessing a product or service built on the framework.
+
+## 3. License Models
+
+Any use not covered by Model A or Model B requires **Model C (Enterprise)** and a separate, executed license.
+
+### Model A — Free Use
+
+**Eligibility:** Natural persons, academic/research institutions, and companies/startups with up to ten (10) employees **and** up to ten (10) Active Users.
+**Grant:** Non-exclusive, revocable, non-transferable right to install and use the framework.
+**Restrictions:** Redistribution (modified or unmodified) is **prohibited**.
+
+### Model B — Free Trial (Evaluation Only)
+
+**Eligibility:** Legal entities/companies.
+**Grant:** Non-exclusive, revocable, non-transferable right to install and use the framework **solely for internal evaluation** for up to thirty (30) consecutive days.
+**Restrictions:** Redistribution and any commercial or production use are **prohibited**.
+
+### Model C — Enterprise License (Paid)
+
+**Eligibility:** Anyone not covered by Model A or B.
+**Grant:** Rights for commercial/production use are available **only** under a separately executed Enterprise License with agreed fees and terms.
+**Restrictions:** **No** redistribution rights are granted by this public License. **Any** redistribution or sublicensing (modified or unmodified) must be expressly permitted in the separate Enterprise License.
+
+## 4. Ownership of Outputs
+
+You own your **Outputs**. However, Outputs, logs, artifacts, or derived model weights may **not** be used to train, fine-tune, or distill any **competing large language model** without an Enterprise License.
+
+## 5. Responsible Use (Prohibited Uses)
+
+You shall not use the framework or Outputs for:
+
+* illegal activities;
+* surveillance without lawful authority;
+* military or autonomous weapon systems;
+* disinformation;
+* life-critical systems (including medical devices, aviation, nuclear) **without** an Enterprise License;
+* any use reasonably expected to cause material harm to individuals, society, or the environment.
+
+## 6. Additional Restrictions
+
+Except as expressly permitted above, you shall **not**:
+
+* copy, distribute, publish, sublicense, rent, lease, or otherwise make the framework available to third parties;
+* modify, adapt, or create derivative works **for any form of distribution**;
+* remove or alter any copyright, attribution, or proprietary notices.
+
+## 7. Attribution & Trademarks
+
+If you publicly reference or showcase the framework (e.g., in documentation, UI credits, research papers, product pages) where such use is **permitted under this License or a separate Enterprise License**, include the attribution:
+
+> “Based on GraphBit by InfinitiBit GmbH https://graphbit.ai
+
+No rights are granted to use the Licensor’s names, logos, or trademarks beyond the attribution above. **This clause does not grant any right to distribute the framework.**
+
+## 8. Termination
+
+Licensor may terminate this License with one month’s notice to the end of the following month. Either party may terminate for cause without notice if the other party materially breaches this License and fails to cure within a reasonable period after written notice, or upon the Licensee’s insolvency, or in case of actions likely to cause significant reputational damage to Licensor.
+Upon termination, you must immediately stop using the framework and destroy all copies. Unauthorized Enterprise Use obligates Licensee to pay retroactive license fees and damages.
+
+## 9. Warranty Disclaimer
+
+THE FRAMEWORK IS PROVIDED “AS IS,” as described in the GraphBit documentation, **without** warranties of any kind, express or implied, including merchantability, fitness for a particular purpose, or non-infringement.
+
+## 10. Limitation of Liability
+
+Licensor is liable only for defects and damages caused by intentional or grossly negligent conduct, and for damages resulting from injury to life, limb, or health, in accordance with applicable law.
+
+## 11. Governing Law & Jurisdiction
+
+This License is governed by the laws of the Federal Republic of Germany. Exclusive jurisdiction lies with the competent courts of Munich, Germany.
+
+## 12. Contact
+
+For Enterprise Licensing or commercial inquiries:
+[contact@infinitibit.com](mailto:contact@infinitibit.com) — [https://graphbit.ai](https://graphbit.ai)

graphbit-0.5.0/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: graphbit
+Version: 0.5.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+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: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+License-File: LICENSE.md
+Summary: Production-grade Python bindings for GraphBit agentic workflow automation
+Keywords: ai,automation,workflow,agent,llm
+Home-Page: https://graphbit.ai
+Author: GraphBit Team
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+<div align="center">
+
+# GraphBit - High Performance Agentic Framework
+
+<p align="center">
+    <img src="assets/logo(circle).png" width="160px" alt="Logo" />
+</p>
+
+<!-- Added placeholders for links, fill it up when the corresponding links are available. -->
+<p align="center">
+    <a href="https://graphbit.ai/">Website</a> | 
+    <a href="https://docs.graphbit.ai/">Docs</a> |
+    <a href="https://discord.com/invite/huVJwkyu">Discord</a>
+    <br /><br />
+</p>
+
+[![Build Status](https://img.shields.io/github/actions/workflow/status/InfinitiBit/graphbit/update-docs.yml?branch=main)](https://github.com/InfinitiBit/graphbit/actions/workflows/update-docs.yml)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/InfinitiBit/graphbit/blob/main/CONTRIBUTING.md)
+[![Rust Version](https://img.shields.io/badge/rust-1.70+-blue.svg)](https://www.rust-lang.org)
+[![Python Version](https://img.shields.io/badge/python-3.10--3.13-blue.svg)](https://www.python.org)
+
+**Type-Safe AI Agent Workflows with Rust Performance**
+
+</div>
+
+Graphbit is an **industry-grade agentic AI framework** built for developers and AI teams that demand stability, scalability, and low resource usage. 
+
+Written in **Rust** for maximum performance and safety, it delivers up to **68× lower CPU usage** and **140× lower memory** footprint than certain leading alternatives while consistently using far fewer resources than the rest, all while maintaining comparable throughput and execution speed. See [benchmarks](benchmarks/report/framework-benchmark-report.md) for more details.
+
+Designed to run **multi-agent workflows in parallel**, Graphbit persists memory across steps, recovers from failures, and ensures **100% task success** under load. Its lightweight, resource-efficient architecture enables deployment in both **high-scale enterprise environments** and **low-resource edge scenarios**. With built-in observability and concurrency support, Graphbit eliminates the bottlenecks that slow decision-making and erode ROI. 
+
+##  Key Features
+
+- **Tool Selection** - LLMs intelligently select tools based on descriptions
+- **Type Safety** - Strong typing throughout the execution pipeline
+- **Reliability** - Circuit breakers, retry policies, and error handling
+- **Multi-LLM Support** - OpenAI, Azure OpenAI, Anthropic, OpenRouter, DeepSeek, Replicate, Ollama, TogetherAI
+- **Resource Management** - Concurrency controls and memory optimization
+- **Observability** - Built-in metrics and execution tracing
+
+##  Quick Start
+
+### Installation
+Clone the repository
+```bash
+git clone https://github.com/InfinitiBit/graphbit.git
+cd graphbit
+```
+
+Install Rust
+- **Linux/macOS**: 
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh && source $HOME/.cargo/env
+```  
+- **Windows**: Download & run [rustup-init.exe](https://win.rustup.rs/x86_64)  
+
+Install Poetry
+```bash
+curl -sSL https://install.python-poetry.org | python3 -
+```
+
+Install dependencies (recommended to use a Python virtual environment)
+```bash
+poetry install --no-root
+```
+
+Build from source
+```bash
+cargo build --release
+```
+
+Build Python bindings
+```bash
+cd python/
+maturin develop --release
+```
+
+### Environment Setup
+First, set up your API keys:
+```bash
+export OPENAI_API_KEY=your_openai_api_key_here
+export ANTHROPIC_API_KEY=your_anthropic_api_key_here
+export REPLICATE_API_KEY=your_replicate_api_token_here
+```
+
+> **Security Note**: Never commit API keys to version control. Always use environment variables or secure secret management.
+
+### Basic Usage
+```python
+import os
+
+from graphbit import LlmConfig, Executor, Workflow, Node, tool
+
+# Initialize and configure
+config = LlmConfig.openai(os.getenv("OPENAI_API_KEY"), "gpt-4o-mini")
+
+# Create executor
+executor = Executor(config)
+
+# Create tools with clear descriptions for LLM selection
+@tool(_description="Get current weather information for any city")
+def get_weather(location: str) -> dict:
+    return {"location": location, "temperature": 22, "condition": "sunny"}
+
+@tool(_description="Perform mathematical calculations and return results")
+def calculate(expression: str) -> str:
+    return f"Result: {eval(expression)}"
+
+# Build workflow
+workflow = Workflow("Analysis Pipeline")
+
+# Create agent nodes
+smart_agent = Node.agent(
+    name="Smart Agent",
+    prompt="What's the weather in Paris and calculate 15 + 27?",
+    system_prompt="You are an assistant skilled in weather lookup and math calculations. Use tools to answer queries accurately.",
+    tools=[get_weather, calculate]
+)
+
+processor = Node.agent(
+    name="Data Processor",
+    prompt="Process the results obtained from Smart Agent.",
+    system_prompt="""You process and organize results from other agents.
+
+    - Summarize and clarify key points
+    - Structure your output for easy reading
+    - Focus on actionable insights
+    """
+)
+
+# Connect and execute
+id1 = workflow.add_node(smart_agent)
+id2 = workflow.add_node(processor)
+workflow.connect(id1, id2)
+
+result = executor.execute(workflow)
+print(f"Workflow completed: {result.is_success()}")
+print("\nSmart Agent Output: \n", result.get_node_output("Smart Agent"))
+print("\nData Processor Output: \n", result.get_node_output("Data Processor"))
+```
+
+## High-Level Architecture
+
+<p align="center">
+  <img src="assets/architecture.svg" height="250" alt="GraphBit Architecture">
+</p>
+
+Three-tier design for reliability and performance:
+- **Rust Core** - Workflow engine, agents, and LLM providers
+- **Orchestration Layer** - Project management and execution
+- **Python API** - PyO3 bindings with async support
+
+## Python API Integrations
+
+GraphBit provides a rich Python API for building and integrating agentic workflows, including executors, nodes, LLM clients, and embeddings. For the complete list of classes, methods, and usage examples, see the [Python API Reference](docs/api-reference/python-api.md).
+
+## Contributing to GraphBit
+
+We welcome contributions. To get started, please see the [Contributing](CONTRIBUTING.md) file for development setup and guidelines.
+
+GraphBit is built by a wonderful community of researchers and engineers.
+
+<a href="https://github.com/Infinitibit/graphbit/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Infinitibit/graphbit" />
+</a>
+

graphbit-0.5.0/README.md

@@ -0,0 +1,165 @@
+<div align="center">
+
+# GraphBit - High Performance Agentic Framework
+
+<p align="center">
+    <img src="assets/logo(circle).png" width="160px" alt="Logo" />
+</p>
+
+<!-- Added placeholders for links, fill it up when the corresponding links are available. -->
+<p align="center">
+    <a href="https://graphbit.ai/">Website</a> | 
+    <a href="https://docs.graphbit.ai/">Docs</a> |
+    <a href="https://discord.com/invite/huVJwkyu">Discord</a>
+    <br /><br />
+</p>
+
+[![Build Status](https://img.shields.io/github/actions/workflow/status/InfinitiBit/graphbit/update-docs.yml?branch=main)](https://github.com/InfinitiBit/graphbit/actions/workflows/update-docs.yml)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/InfinitiBit/graphbit/blob/main/CONTRIBUTING.md)
+[![Rust Version](https://img.shields.io/badge/rust-1.70+-blue.svg)](https://www.rust-lang.org)
+[![Python Version](https://img.shields.io/badge/python-3.10--3.13-blue.svg)](https://www.python.org)
+
+**Type-Safe AI Agent Workflows with Rust Performance**
+
+</div>
+
+Graphbit is an **industry-grade agentic AI framework** built for developers and AI teams that demand stability, scalability, and low resource usage. 
+
+Written in **Rust** for maximum performance and safety, it delivers up to **68× lower CPU usage** and **140× lower memory** footprint than certain leading alternatives while consistently using far fewer resources than the rest, all while maintaining comparable throughput and execution speed. See [benchmarks](benchmarks/report/framework-benchmark-report.md) for more details.
+
+Designed to run **multi-agent workflows in parallel**, Graphbit persists memory across steps, recovers from failures, and ensures **100% task success** under load. Its lightweight, resource-efficient architecture enables deployment in both **high-scale enterprise environments** and **low-resource edge scenarios**. With built-in observability and concurrency support, Graphbit eliminates the bottlenecks that slow decision-making and erode ROI. 
+
+##  Key Features
+
+- **Tool Selection** - LLMs intelligently select tools based on descriptions
+- **Type Safety** - Strong typing throughout the execution pipeline
+- **Reliability** - Circuit breakers, retry policies, and error handling
+- **Multi-LLM Support** - OpenAI, Azure OpenAI, Anthropic, OpenRouter, DeepSeek, Replicate, Ollama, TogetherAI
+- **Resource Management** - Concurrency controls and memory optimization
+- **Observability** - Built-in metrics and execution tracing
+
+##  Quick Start
+
+### Installation
+Clone the repository
+```bash
+git clone https://github.com/InfinitiBit/graphbit.git
+cd graphbit
+```
+
+Install Rust
+- **Linux/macOS**: 
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh && source $HOME/.cargo/env
+```  
+- **Windows**: Download & run [rustup-init.exe](https://win.rustup.rs/x86_64)  
+
+Install Poetry
+```bash
+curl -sSL https://install.python-poetry.org | python3 -
+```
+
+Install dependencies (recommended to use a Python virtual environment)
+```bash
+poetry install --no-root
+```
+
+Build from source
+```bash
+cargo build --release
+```
+
+Build Python bindings
+```bash
+cd python/
+maturin develop --release
+```
+
+### Environment Setup
+First, set up your API keys:
+```bash
+export OPENAI_API_KEY=your_openai_api_key_here
+export ANTHROPIC_API_KEY=your_anthropic_api_key_here
+export REPLICATE_API_KEY=your_replicate_api_token_here
+```
+
+> **Security Note**: Never commit API keys to version control. Always use environment variables or secure secret management.
+
+### Basic Usage
+```python
+import os
+
+from graphbit import LlmConfig, Executor, Workflow, Node, tool
+
+# Initialize and configure
+config = LlmConfig.openai(os.getenv("OPENAI_API_KEY"), "gpt-4o-mini")
+
+# Create executor
+executor = Executor(config)
+
+# Create tools with clear descriptions for LLM selection
+@tool(_description="Get current weather information for any city")
+def get_weather(location: str) -> dict:
+    return {"location": location, "temperature": 22, "condition": "sunny"}
+
+@tool(_description="Perform mathematical calculations and return results")
+def calculate(expression: str) -> str:
+    return f"Result: {eval(expression)}"
+
+# Build workflow
+workflow = Workflow("Analysis Pipeline")
+
+# Create agent nodes
+smart_agent = Node.agent(
+    name="Smart Agent",
+    prompt="What's the weather in Paris and calculate 15 + 27?",
+    system_prompt="You are an assistant skilled in weather lookup and math calculations. Use tools to answer queries accurately.",
+    tools=[get_weather, calculate]
+)
+
+processor = Node.agent(
+    name="Data Processor",
+    prompt="Process the results obtained from Smart Agent.",
+    system_prompt="""You process and organize results from other agents.
+
+    - Summarize and clarify key points
+    - Structure your output for easy reading
+    - Focus on actionable insights
+    """
+)
+
+# Connect and execute
+id1 = workflow.add_node(smart_agent)
+id2 = workflow.add_node(processor)
+workflow.connect(id1, id2)
+
+result = executor.execute(workflow)
+print(f"Workflow completed: {result.is_success()}")
+print("\nSmart Agent Output: \n", result.get_node_output("Smart Agent"))
+print("\nData Processor Output: \n", result.get_node_output("Data Processor"))
+```
+
+## High-Level Architecture
+
+<p align="center">
+  <img src="assets/architecture.svg" height="250" alt="GraphBit Architecture">
+</p>
+
+Three-tier design for reliability and performance:
+- **Rust Core** - Workflow engine, agents, and LLM providers
+- **Orchestration Layer** - Project management and execution
+- **Python API** - PyO3 bindings with async support
+
+## Python API Integrations
+
+GraphBit provides a rich Python API for building and integrating agentic workflows, including executors, nodes, LLM clients, and embeddings. For the complete list of classes, methods, and usage examples, see the [Python API Reference](docs/api-reference/python-api.md).
+
+## Contributing to GraphBit
+
+We welcome contributions. To get started, please see the [Contributing](CONTRIBUTING.md) file for development setup and guidelines.
+
+GraphBit is built by a wonderful community of researchers and engineers.
+
+<a href="https://github.com/Infinitibit/graphbit/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Infinitibit/graphbit" />
+</a>

graphbit-0.5.0/core/Cargo.toml

@@ -0,0 +1,59 @@
+[dependencies]
+pyo3 = {workspace = true, optional = true}
+anyhow.workspace = true
+async-trait.workspace = true
+chrono.workspace = true
+csv.workspace = true
+docx-rs.workspace = true
+futures.workspace = true
+lazy_static.workspace = true
+lopdf.workspace = true
+petgraph.workspace = true
+quick-xml.workspace = true
+rand.workspace = true
+regex.workspace = true
+reqwest.workspace = true
+scraper.workspace = true
+serde.workspace = true
+serde_json.workspace = true
+thiserror.workspace = true
+tokio.workspace = true
+tracing.workspace = true
+tracing-subscriber.workspace = true
+uuid.workspace = true
+
+[features]
+default = []
+python = ["pyo3"]
+
+[lints]
+workspace = true
+
+[package]
+description = "Core engine for GraphBit agentic workflow automation"
+name = "graphbit-core"
+authors.workspace = true
+categories.workspace = true
+documentation.workspace = true
+edition.workspace = true
+homepage.workspace = true
+keywords.workspace = true
+license-file.workspace = true
+repository.workspace = true
+rust-version.workspace = true
+version.workspace = true
+readme = "README.md"
+
+# Enable vendored OpenSSL for aarch64 cross-compilation
+# Cross-compilation containers lack aarch64-specific OpenSSL dev packages
+[target.aarch64-unknown-linux-gnu]
+[target.aarch64-unknown-linux-gnu.dependencies]
+openssl = {version = "0.10", features = ["vendored"]}
+
+# Enable vendored OpenSSL for musl targets (Alpine Linux)
+# musl containers don't have OpenSSL dev packages, so we compile from source
+[target.'cfg(target_env = "musl")'.dependencies]
+openssl = {version = "0.10", features = ["vendored"]}
+
+[target.'cfg(unix)'.dependencies]
+jemallocator.workspace = true