superglue  by superglue-ai

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

created 6 months ago
1,875 stars

Top 23.6% 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

1 day ago

Responsiveness

1 day

Pull Requests (30d)
44
Issues (30d)
5
Star History
168 stars in the last 90 days

Explore Similar Projects

Starred by Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), and
3 more.

composio by ComposioHQ

0.2%
26k
Toolset for AI agent integrations via function calling
created 1 year ago
updated 22 hours ago
Feedback? Help us improve.