polterguy/magic
Instant SECURE Full Stack Apps and AI Agents
Magic – 즉시 보안 풀스택 앱 및 AI 에이전트
개요
Magic은 일반 영어 설명을 완전한 자체 호스팅 풀스택 애플리케이션으로 변환할 수 있는 오픈소스 플랫폼입니다. 자동으로 다음을 생성합니다:
- 관계형 데이터베이스 스키마(또는 기존 데이터베이스 연결),
- 역할 기반 액세스 제어(RBAC)를 갖춘 보안 REST API,
- 앱 관리를 위한 React 기반 대시보드, 그리고
- 생성된 엔드포인트를 호출할 수 있는 선택적 AI 기반 에이전트.
모든 구성 요소는 사용자 자신의 하드웨어에서 실행됩니다. SaaS 종속은 없습니다. 핵심 런타임은 Hyperlambda로, LLM이 생성하고 샌드박스 내에서 실행할 수 있는 컴파일된 .NET 기반 언어입니다.
주요 기능(README에서)
| 기능 | 제공 내용 |
|---|---|
| 원클릭 시작 | `curl … |
| 자연어 생성 | 데이터베이스, 엔드포인트 또는 UI를 일반 영어로 설명하면 내장 생성기가 Hyperlambda, SQL, HTML 또는 CSS를 작성합니다. |
| 보안 자체 호스팅 백엔드 | 컴파일된 .NET 런타임, 샌드박스 Hyperlambda, 함수별 화이트리스트, RBAC, JWT 인증, OIDC 로그인(Google, GitHub, Azure AD 등). |
| MCP 서버 | 모든 엔드포인트가 Model Communication Protocol 도구로 노출되어 Claude, Cursor, Codex, Qoder 등이 직접 호출할 수 있습니다. |
| AI 에이전트 친화적 | 에이전트는 자체 데이터베이스를 쿼리/업데이트하고, 자체 API를 호출하고, 백그라운드 작업을 실행할 수 있습니다. 모두 자체 액세스 제어 뒤에서 이루어집니다. |
| 타사 API 가져오기 | OpenAPI/Swagger URL을 붙여넣으면 Magic이 자동 검증이 포함된 유형화되고 문서화된 CRUD 스타일 래퍼를 생성합니다. |
| 샌드박스 API | 호출자가 제공한 Hyperlambda(또는 영어로 생성된 코드)를 역할 기반 화이트리스트 내에서 실행하는 엔드포인트를 생성합니다. 안전한 "코드 실행 서비스"입니다. |
| 웹 디자이너 | 브라우저 내 WYSIWYG 편집기로 디스크의 실제 HTML 파일을 직접 편집합니다. 60개 이상의 사전 구축 블록, 실시간 미리보기, AI 지원 편집을 제공합니다. |
| Chat Ops | 전역 "Ctrl+." 단축키로 채팅 창이 열려 서버에 코드 생성, 함수 실행 또는 데이터 검색을 요청할 수 있습니다. 모델의 작업은 서버 측에서 실행되고 실시간 상태 알약으로 표시됩니다. |
| Rewind 디버거 | 실행을 기록한 다음 각 문을 전체 변수 값과 함께 앞뒤로 단계별 실행할 수 있습니다. |
| 성능 | Hyperlambda가 네이티브 .NET 코드로 컴파일되므로 FastAPI/Flask보다 20배, LangChain보다 50배, 워크플로 도구보다 최대 1,000배 빠르다고 주장합니다. |
| 배포 옵션 | Docker Compose(빠른 시작), DigitalOcean 드롭릿(단일 노드), Kubernetes(클러스터) 또는 소스에서 실행(.NET 10 + Node). |
| AI 모델 유연성 | 기본적으로 OpenAI를 사용하지만 Ollama, HuggingFace 및 임베딩이 필요 없는 로컬 BM25 검색 폴백도 지원합니다. |
| 확장 가능한 언어 | Hyperlambda는 C# 함수 호출, Python 스크립트 실행, Bash 명령 실행 또는 PuppeteerSharp를 사용한 헤드리스 브라우저 자동화가 가능합니다. |
작동 방식(높은 수준의 흐름)
- 스택 시작 – Docker Compose가 백엔드 컨테이너(
magic-backend)와 프론트엔드 컨테이너(magic-frontend)를 시작합니다. - 로그인 – 기본 관리자 사용자
root/root(또는 OIDC 구성). 각 세션에 대해 JWT가 발급됩니다. - 프로젝트 생성 – 대시보드에서 Endpoint Generator 또는 API Wizard를 사용합니다. 데이터베이스(MySQL, PostgreSQL, SQL Server, MariaDB) 또는 OpenAPI 사양을 지정합니다.
- 필요한 것 설명 – "Machine Creates the Code" 표시줄에 자연어 프롬프트를 입력합니다. LLM이 Hyperlambda용 AST(추상 구문 트리)를 생성합니다. 시스템은 저장 전에 호출된 모든 함수의 존재를 검증합니다.
- 실행 / 디버그 – IDE에서 직접 생성된 파일을 실행하거나 Debug를 클릭하여 단계별 추적을 기록합니다.
- MCP 도구로 노출 – MCP 플러그인이 각 HTTP 엔드포인트를 호환 가능한 LLM이 호출할 수 있는 도구로 자동 등록하여 토큰 사용량을 약 80% 줄입니다.
- 배포 – 모든 것이 사용자 머신에서 실행되므로 포트를 노출하거나 컨테이너를 리버스 프록시 뒤에 두면 됩니다(Caddy는 DigitalOcean에서 HTTPS용으로 사전 구성됨). 추가 빌드 또는 게시 단계가 필요 없습니다.
사용 대상
- 개인 개발자 또는 소규모 팀 – 보일러플레이트 코드를 작성하지 않고 CRUD 앱을 빠르게 프로토타이핑하려는 경우.
- 기업 – 데이터를 온프레미스로 유지하면서 AI 지원 개발 및 내부 에이전트를 원하는 경우.
- AI 운영 팀 – 레거시 데이터베이스 또는 내부 서비스와 안전하게 상호 작용하는 사용자 지정 에이전트를 구축하는 경우.
- 교육자 / 해커톤 참가자 – AI 생성 코드와 안전한 샌드박스 실행을 보여주는 데모 준비 플랫폼을 찾는 경우.
제한 사항 / 고려 사항(README에 명시됨)
- LLM은 여전히 논리적으로 올바르지 않은 코드를 생성할 수 있습니다. 함수 존재만 보장됩니다.
- 보안은 올바른 RBAC 구성과 화이트리스트에 의존합니다. 잘못된 구성은 위험한 함수를 노출할 수 있습니다.
- 성능 주장은 작성자의 벤치마크를 기반으로 합니다. 실제 결과는 다를 수 있습니다.
- 플랫폼은 비교적 새롭습니다. 커뮤니티 지원과 생태계(플러그인, 확장)는 아직 성장 중입니다.
빠른 시작 요약
curl -fsSL https://hyperlambda.dev/docker-compose.yaml | docker compose -f - up
# 그런 다음 http://localhost:5555를 열고 root/root로 로그인
대시보드에서 즉시 API Wizard를 샘플 chinook 데이터베이스로 지정하고 50개 이상의 보안 엔드포인트가 나타나는 것을 볼 수 있습니다.
위의 모든 정보는 저장소의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트