superglue  by superglue-ai

Integration agent for automating workflows across apps, APIs, and databases

Created 8 months ago
1,907 stars

Top 22.9% on SourcePulse

GitHubView on GitHub
Project Summary

Superglue is a self-healing integration agent designed to automate workflows by acting as a proxy between users and complex or legacy APIs. It enables users to interact with APIs using natural language prompts, transforming them into deterministic API calls with guaranteed data schema adherence. The primary audience includes developers and businesses seeking to streamline data integration and automate complex processes across applications, APIs, and databases.

How It Works

Superglue analyzes API documentation to automatically generate configurations, handling complexities like pagination, authentication, and error retries. It uses LLMs during the initial setup and transformation rule creation (using JSONata) to ensure deterministic and efficient data mapping. Crucially, it validates incoming data against a defined schema and automatically corrects broken transformations, ensuring consistent output formats and reducing manual intervention.

Quick Start & Requirements

  • Hosted Version: Install the JS/TS client via npm install @superglue/client.
  • Self-Hosted Version:
    • Pull Docker image: docker pull superglueai/superglue.
    • Create a .env file from .env.example.
    • Run: docker run -d --name superglue --env-file .env -p 3000:3000 -p 3001:3001 superglueai/superglue.
    • Verify with curl http://localhost:3000/health.
  • Documentation: docs.superglue.cloud

Highlighted Details

  • LLM-powered data mapping for automated transformation rule generation.
  • Self-healing capabilities ensure data schema compliance and automatic fixes.
  • Supports flexible authentication methods (header, API keys, OAuth).
  • Handles various file formats (CSV, JSON, XML) with automatic decompression.

Maintenance & Community

  • Active development indicated by Y Combinator backing and multiple contributors.
  • Community support available via Discord.
  • Contributions are welcomed via GitHub Issues.

Licensing & Compatibility

  • The core Superglue agent is licensed under GPL.
  • Client SDKs are MIT licensed.
  • The GPL license may impose copyleft restrictions on derivative works, potentially impacting commercial use in closed-source applications.

Limitations & Caveats

The core agent's GPL license may restrict its use in proprietary, closed-source commercial products without adherence to the GPL's terms.

Health Check
Last Commit

14 hours ago

Responsiveness

1 day

Pull Requests (30d)
30
Issues (30d)
4
Star History
19 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.