intelligo

Intelligo
버티컬 AI SaaS를 위한 애플리케이션 프레임워크.

에이전트는 당신이 만듭니다. 이미 사용 중인 AI 프레임워크로.

Intelligo는 그 주변의 모든 것을 담당합니다 — 테스트되고, 타입이 지정되고, 당신의 것입니다.

Website · Docs · Blocks · Components · Architecture · Why

첫 12초. 영상 전체(1분)를 보세요 — 소스로서의 페이지, 실행 경계, 사용량, 그리고 그것을 당신의 것으로 만드는 설정.

상태: 1.0. npm의 latest 로 배포되며, 공개 API는 시맨틱 버저닝을 따릅니다. 이 페이지의 모든 것은 오늘날 존재하고 실행됩니다.

나머지 절반
AI 제품은 두 개의 절반으로 이루어집니다.

하나는 당신의 에이전트입니다: 프롬프트, 도구, 아무도 갖지 못한 도메인 지식. 그 절반이 제품이 존재하는 이유입니다.

다른 하나는 지금까지 만들어진 모든 AI SaaS에서 동일합니다: 누가 로그인했는지, 어느 워크스페이스에 속하는지, 그들의 플랜이 이 요청을 허용하는지, 비용이 얼마였는지, 누구에게 청구할지, 나중에 감사자에게 무엇을 알려줄지. 팀들은 대부분의 시간을 이것을 다시 만드는 데 씁니다.

Intelligo는 두 번째 절반을 완성된 상태로 제공하고 첫 번째 절반에는 관여하지 않습니다. IntelligoAgent 는 없고, 모델 호출을 감싸는 래퍼도 없고, 배울 새로운 에이전트 API도 없습니다 — Vercel AI SDK, Mastra, 또는 그 밖의 무엇이든 그 자체 문서에 설명된 대로 정확히 사용하세요.

flowchart LR
subgraph you ["Your application"]
direction TB
pages["Installed pages<br/>(your source)"]
agent["Your agent<br/>any AI framework, unmodified"]
end

subgraph intelligo ["Intelligo packages"]
direction TB
auth["auth · workspaces · roles"]
billing["plans · credits · Stripe"]
exec["executions<br/>admit · settle · audit"]
core["conversations · documents"]
end

registry["Page registry"] -. "shadcn add" .-> pages
pages --> auth & billing & core
agent === |"bracketed, never wrapped"| exec
intelligo --> db[("PostgreSQL")]

Loading

당신에게 맞는가?

만약 당신이 그렇지 않다면…
여기서 다른 점

직접 구축한다면
테넌시, 권한, 크레딧, 미터링, 청구, 감사가 타입이 지정된 서비스로 제공되며, 단위·실제 데이터베이스·아키텍처 테스트 스위트가 이미 둘러싸고 있습니다.

SaaS 보일러플레이트에서 시작한다면
보일러플레이트는 당신 혼자 유지보수하는 포크입니다. 여기서는 서비스가 업그레이드 가능한 패키지로 남고, 페이지는 레지스트리 설치물이며, 당신의 변형은 설정과 메시지 파일에 격리됩니다.

올인원 AI 플랫폼을 도입한다면
그것들은 당신의 에이전트를 소유합니다. Intelligo는 그럴 수 없습니다: 당신을 가둘 에이전트 추상화가 없습니다. 당신의 프레임워크가 만들어내는 실행을 승인하고, 정산하고, 기록할 뿐입니다.

이것은 AI 프레임워크도, 그 위의 래퍼도, 컴포넌트 라이브러리도, 호스팅 플랫폼도 아닙니다 — 여느 Next.js 애플리케이션처럼 배포합니다 — 그리고 런타임 플러그인 시스템은 없습니다: 합성은 의도적으로 빌드 타임에 일어납니다.

빠른 시작
Node 22.14+, pnpm 9, 그리고 pgvector가 있는 PostgreSQL이 필요합니다 (Neon, Supabase, 또는 docker run pgvector/pgvector:pg17 ).

# asks which pages you want, then installs them as your source — tick the chat
pnpm dlx @intelligo-dev/cli create my-app
cd my-app
건너뛴 것은 나중에 설치할 수 있습니다. 스캐폴드의 components.json이 @intelligo 로 지정한 레지스트리에서: pnpm exec shadcn add @intelligo/billing-settings . 블록은 의존성 순서 로 설치되며, create 가 이를 알아서 처리합니다.

.env.example 을 .env.local 로 복사하고, DATABASE_URL 과 BETTER_AUTH_SECRET ( openssl rand -base64 32 )을 설정한 다음:

pnpm db:migrate # the framework's schema, then your own tables
pnpm dev
가입하고, 대시보드에 도착하고, 채팅하세요. 채팅은 내장 스텁 모델에 대해 스트리밍되고 이메일은 서버 콘솔에 출력되므로, 먼저 구성할 것은 아무것도 없습니다. Team, billing, usage, notifications, artifacts는 같은 레지스트리의 추가 항목입니다. 시작 가이드 가 여기서부터 이어가며, Bring your agent 는 당신의 것이 어디에 연결되는지 보여줍니다.

하나의 요청, 처음부터 끝까지
모든 AI 실행은 감싸지지 않고 괄호로 둘러싸입니다 . 당신의 라우트는 당신의 프레임워크 고유의 관용구로 작성된 채로 남고, Intelligo는 그 양쪽에 섭니다:

const run = await executions . begin ( { workspaceId , userId , capability , model } ) ;
if ( ! run . allowed ) return refuse ( run . reason ) ;

const result = await yourAgent . generate ( messages ) ; // your framework, unmodified

await run . complete ( { usage : result . usage } ) ; // or, in catch: run.fail({ error })

승인 — 플랜은 포트를 통해 확인되고, 최악의 경우 비용은 워크스페이스의 크레딧에 대해 보류되며, 실행 행이 기록됩니다. 거부도 기록됩니다.
실행 — 당신의 코드. 핸들은 메시지, 도구, 모델에 대해 아무것도 모릅니다.
정산 — 실제 토큰과 비용이 기록되고 크레딧이 청구되며, compare-and-swap 방식으로 처리되어 중복된 complete가 이중 청구할 수 없습니다. 실패 시 보류가 해제되고, 프로세스가 죽으면 만료됩니다.

모델 id는 토큰당 가격이 있는 레지스트리 키입니다. 가격이 없는 id는 승인 시 거부되고 아키텍처 테스트를 실패시킵니다 — 조용한 오청구는 결코 없습니다. 라우트를 아예 작성하고 싶지 않다면, @intelligo-dev/chat 이 동일한 생명주기를 두 줄로 제공합니다:

// app/api/chat/route.ts
export const { POST , DELETE } = createChatHandler ( chatServerConfig ) ;
무엇이 제공되는가
서비스는 업그레이드하는 npm 패키지에 있습니다. 각각은 의존성을 포트로 받고, 타입이 지정된 오류를 반환하며, 실제 데이터베이스에 대해 테스트됩니다.

Package
What it gives you

@intelligo-dev/auth
이메일/비밀번호 및 OAuth, 인증, 재설정; owner/admin/member가 있는 멀티테넌트 워크스페이스; 전체 초대 생명주기; 소유권 이전; 감사된 임퍼소네이션

@intelligo-dev/billing
당신의 제품이 채우는 플랜 레지스트리; 기능 게이트, 할당량, 속도 제한; 예약이 있는 크레딧 잔액; 체험; Stripe 구독, 크레딧 팩, 멱등 웹훅

@intelligo-dev/executions
위의 실행 경계; 모델 가격 레지스트리; FX와 마진을 반영한 비용; 요청별 기록과 쿼리 API 뒤의 월별 롤업

@intelligo-dev/chat
AI-SDK 네이티브 채팅 전송: 인증 → 속도 제한 → 기능 게이트 → 영속화 → executions.begin() → 스트림 → 한 번 정산. 에이전트, 컨텍스트, 첨부 파일, 제목을 위한 이음새

@intelligo-dev/core
스키마 (Drizzle, Postgres, pgvector); 대화, 버전 관리되는 문서, 알림; 데이터 내보내기와 팩트별 삭제; 이메일, 로깅, env

@intelligo-dev/jobs
Postgres 기반 작업 큐 — FOR UPDATE SKIP LOCKED , 재시도, 백오프. Redis 없음

@intelligo-dev/audit
추가 전용 감사 이벤트와 메모리 감사 계약

@intelligo-dev/admin
admin-console 블록 뒤의 운영자 콘솔: 교차 테넌트 읽기, 플랫폼 관리자 게이트, 통합 상태, 감사된 임퍼소네이션

@intelligo-dev/next
next/* 를 임포트하는 유일한 패키지: 요청 컨텍스트와 인증 라우트 핸들러

@intelligo-dev/mastra
선택 사항: 네이티브 Mastra 에이전트에서 실행 경계로의 브리지

@intelligo-dev/cli
create , add , migrate (그리고 배포를 게이트하는 --check ), doctor , upgrade --check — 생성된 파일 중 당신이 커스터마이즈한 것을 콘텐츠 해시로 식별하고 덮어쓰지 않습니다

모든 패키지는 intelligo.dev/docs/packages 아래에 자체 페이지가 있습니다 .

당신이 소유하는 블록
페이지는 패키지로 제공되지 않습니다. 레지스트리 블록 — 페이지, 그 주변의 셸, 그리고 배너·게이트·채팅 패널 같은 드롭인 표면 — 으로 도착하며, 표준 shadcn 레지스트리 프로토콜 을 통해 소스 로 당신의 애플리케이션에 설치됩니다 — 페이지, 컴포넌트, 로딩/빈/오류 상태, 그리고 얇은 서버 액션이 당신의 shadcn 프리미티브로 렌더링됩니다:

auth-login
auth-signup
auth-password-reset
auth-email-verification

onboarding
invitation-accept
app-shell
dashboard

settings-shell
workspace-settings
team-settings
profile-settings

privacy-settings
language-switcher
notifications
route-error

pricing
checkout
billing-settings
usage

feature-gating
trial-banner
payment-poll
artifacts

chat
chat-panel
chat-widget
chat-share

admin-console

intelligo.dev/blocks 에서 실행 중인 것을 둘러보고, 디자인 시스템의 컴포넌트 — AI 메시지 파트, 모션 패턴, 재스타일된 프리미티브 — 를 intelligo.dev/components 에서 보세요.

설치된 페이지를 몇 주가 아니라 몇 년 동안 건강하게 유지하는 세 가지 규칙:

설치된 컴포넌트는 그대로 사용됩니다. 당신의 제품이 달라지는 부분은 항목이 편집하도록 제공하는 설정 파일에 들어갑니다 — 내비게이션, 배너, 온보딩 단계, 크레딧 번들, 에이전트의 정체성, 대화 시작 문구, 도구 렌더러. 나중에 항목을 재설치해도 당신의 설정은 살아남습니다.
카피는 번역이지 코드가 아닙니다. 모든 항목은 자체 next-intl 네임스페이스에서 문자열을 읽습니다. 언어 추가는 메시지 파일 추가입니다.
비즈니스 규칙은 페이지 뒤에 있습니다. 설치된 액션은 파싱하고, 타입이 지정된 서비스를 호출하고, 오류를 매핑하고, 재검증합니다. 불변 조건은 패키지에 있습니다.

어떻게 구축되었는가

하나의 PostgreSQL 데이터베이스 , 모든 테이블의 명시적 소유권과 함께. pgvector가 함께하며, Redis도 별도의 벡터 저장소도 없습니다.
하나의 서비스 계층, 두 개의 얇은 전송 — 변경을 위한 Server Actions, 스트리밍과 웹훅을 위한 라우트 핸들러.
애플리케이션당 하나의 합성 루트. 레지스트리는 그것으로부터 명시적으로 채워지며, 임포트 부작용에 의한 등록은 금지됩니다.
AI 프레임워크는 네이티브로 유지됩니다. Intelligo가 실행에 대해 기록하는 유일한 것은 그 경계입니다.
머니는 통화가 붙은 마이크로 이며, 배포는 청구할 통화를 하나 선언합니다.
아키텍처는 문서가 아니라 실패하는 테스트입니다. 의존성 방향, 테넌트 스코핑, 레지스트리 위생, 모델 id 등록은 위반 시 빌드를 깨뜨립니다.

패키지 그래프와 함께한 더 긴 버전은 intelligo.dev/architecture 에 있습니다.

이 저장소
packages/ 프레임워크: core · auth · next · billing · chat · executions · audit · jobs · admin · mastra · cli
packages/registry/ 페이지 레지스트리의 소스 — 프라이빗 워크스페이스, `pnpm registry:build`로 빌드
apps/app 레퍼런스 애플리케이션: `create` + `shadcn add`가 만들어내는 것과 정확히 동일하며, CI에 의해 재생성됩니다.
완성된 설치를 보려면 읽으세요; 그 안에서 빌드하지 마세요
apps/website intelligo.dev — 사이트와 문서, /r 에서 레지스트리도 제공
tools/film 위의 1분 영상 (Remotion)
tests/architecture 규칙, 테스트로서

무엇이든 설치하기 전에 둘러보려면: 클론하고, pnpm install && pnpm dev , 그리고 :4002 에서 레퍼런스 애플리케이션을 여세요 — 공개 패키지와 레지스트리만으로 만들어진 완전하고 일반적인 워크스페이스 AI SaaS입니다.

pnpm dev # reference app :4002, website :4003
pnpm test # unit, real-database integration and architecture suites
pnpm lint && pnpm type-check
pnpm registry:build # rebuild the registry artifacts
pnpm db:migrate # apply the framework's schema
릴리스는 하나의 스쿼시 머지된 풀 리퀘스트입니다: 모든 게시된 패키지를 범프하고 CHANGELOG.md를 해당 섹션으로 시작하며, 머지하면 provenance, 태그와 함께 npm에 게시하고 GitHub 릴리스를 생성합니다. CONTRIBUTING.md 는 변경을 시작하는 곳이며, AGENTS.md 는 코딩 에이전트가 로드하는 코드베이스의 전체 지도입니다.

커뮤니티
질문과 아이디어는 Discussions 로, 버그는 issues 로, 취약점은 SECURITY.md 가 설명하는 방식대로 비공개로 보내주세요. SUPPORT.md 와 행동 강령 도 참고하세요. 프로젝트가 운영되는 방식과 메인테이너가 되는 방법: GOVERNANCE.md .

라이선스
Apache-2.0 · NOTICE · TRADEMARK.md