nango README

The project's README from github.com/NangoHQ/nango. As one markdown file: README.md.

Build product integrations with AI.

Connect your product & AI agents with 900+ APIs. Build, run, and maintain integrations with AI in code, on infrastructure built for scale.

Website · Docs · 900+ APIs · Slack Community

GitHub Stars License NPM Downloads

What is Nango?

Nango is an open-source platform for building product integrations. It supports 900+ APIs and works with any backend language, AI coding tool, and agent SDK.

You write integration logic as TypeScript functions, or let AI generate them for you, and deploy to Nango's production runtime. Nango handles auth, execution, scaling, and observability.

Used in production by Replit, Ramp, Mercor, and hundreds more.

How it works

Nango gives you three primitives that cover every integration pattern:

1. Auth

Managed OAuth, API keys, and token refresh for 900+ APIs. Embed a white-label auth flow in your app. Nango handles credentials, token storage, and multi-tenant connection management.

// Embed auth in your frontend
nango.openConnectUI({ onEvent: (event) => { /* handle completion */ } });

2. Proxy

Make authenticated API requests on behalf of your users. Send requests through Nango's proxy: it resolves the provider, injects credentials, handles retries and rate limits, and returns the response.

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

// Make an authenticated request to any API
const response = await nango.get({
    endpoint: '/v3/contacts',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

3. Functions

Write integration logic as TypeScript functions and deploy to Nango. Functions execute on a production runtime with built-in API access, retries, storage, and observability.

Use the AI builder to generate them from a description of your use case.

export default async function run(nango: Nango) {
    const { owner, repo, title, body } = nango.input;
    
    const response = await nango.post({
        endpoint: `/repos/${owner}/${repo}/issues`,
        data: { title, body }
    });
    
    return response.data;
}

What you can build

Nango supports every common integration pattern:

Use case Description
AI tool calling & MCP Give AI agents the ability to act on external APIs
Data syncing One or two-way sync for RAG pipelines, indexing, and triggers
Webhook processing Receive and process webhooks from external APIs reliably
API unification Normalize APIs to your own universal schema
Actions Write data and execute operations on behalf of your users
Per-customer config Customize integration behavior for each customer

Quickstart

Get up and running in under 5 minutes:

1. Create an integration. Sign up (free, no credit card), then configure a new integration in the Integrations tab.

2. Authorize the API. On the Connections tab, create a connection and complete the auth flow. Later, embed this in your product:

nango.openConnectUI({ onEvent: (event) => { /* handle completion */ } });

3. Access the API. Retrieve credentials and make authenticated requests:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const connection = await nango.getConnection('<INTEGRATION-ID>', '<CONNECTION-ID>');
console.log(connection.credentials);

Embed the Auth flow in your product, make requests with the Proxy, or build custom integrations with Functions.

Why Nango?

AI-generated, human-controlled code. Nango's AI builder generates TypeScript integration functions from natural language. Unlike black-box solutions, you get readable code you can review, edit, and version control. With full type safety and a built-in testing framework.

Production-grade infrastructure. Nango processes billions of API requests. The runtime provides per-tenant isolation, elastic scaling, automatic retries, and rate-limit handling. Battle-tested by hundreds of companies in production.

Auth for 900+ APIs, out of the box. OAuth flows, token refresh, credential storage, and multi-tenant support handled for you. Connect to any API without building auth from scratch.

Open source and self-hostable. Nango is fully open source. Run it on Nango Cloud or self-host on your own infrastructure. SOC 2 Type II, HIPAA, and GDPR compliant.

Fits your workflow. Fully operable via CLI and API. Compatible with any backend language or framework, AI coding tools (Cursor, Codex, Claude Code), and agent SDKs (MCP, LangChain).

Open-source vs. paid

Nango is available under the Elastic License. The Cloud and Enterprise Self-Hosted versions give you access to all features, based on your plan. You can also self-host for free with a limited feature set.

Contributing

We welcome contributions — anyone can add support for a new API.

Thank you to all contributors ❤️

nango (NangoHQ/nango)

Searching Database…

12.7K ·GitHub
这是什么?Nango 是一个开源平台,用于构建产品集成,可将你的产品和 AI 智能体连接到 900 多个 API,并为你处理认证、执行、扩展和可观测性等工作。
这是托管服务,还是需要我自己部署?两者都支持:你可以使用 Nango Cloud 托管服务,也可以把它部署在自己的基础设施上,因为整个平台都是开源的。
它支持哪些编程智能体和编程语言?Nango 支持任何后端语言或框架,支持 Cursor、Codex 和 Claude Code 等 AI 编程工具,也支持 MCP 和 LangChain 等智能体 SDK。
如果我免费自部署而不付费,会失去什么?免费的自部署版本功能有限;要使用全部功能,需要购买 Cloud 或 Enterprise 自部署方案。
AI 构建器是什么?它会根据你用自然语言描述的使用场景生成 TypeScript 集成函数,让你得到可读、可编辑、可进行版本管理的代码,而不是一个黑盒。
三个核心组成部分是什么?Auth 负责管理 900 多个 API 的 OAuth 和 API 密钥;Proxy 代表用户发送已认证的请求;Functions 允许你用 TypeScript 代码编写并部署自定义集成逻辑。
Nango 是否已在大规模生产环境中使用?是的,Replit、Ramp 和 Mercor 等公司已在生产环境中使用它;其运行时可处理数十亿次 API 请求,并支持租户级隔离和弹性扩展。
它能否用于处理敏感的客户数据?Nango 声明其符合 SOC 2 Type II、HIPAA 和 GDPR 标准,因此可以用于受监管或敏感的数据。
Creator
NangoHQ
Size
372.5 MB
Stars
12.7K
Age
6y
Commits · 90 Days