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(または英語で生成されたコード)をロールベースのホワイトリスト内で実行するエンドポイントを生成します。安全な「コード実行サービス」です。 |
| Web デザイナー | ブラウザ内 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 から直接取得したものです。追加の機能は推測されていません。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト