JOYCEQL/magic-resume

これは何か

Magic Resume はオンライン履歴書エディタです。ブラウザでプロフェッショナルな履歴書を作成、編集、スタイル設定できる Web アプリで、入力中にライブプレビューが表示されます。

主な機能（README より）

リアルタイムプレビュー — 変更を即座に確認
カスタムテーマ — 履歴書の外観を変更
ダークモード — ダークカラースキームオプション
PDF にエクスポート — 完成した履歴書を PDF としてダウンロード
自動保存 — 作業は自動的に保存されます
ローカルストレージ — データはサーバーではなくブラウザに保存されます
レスポンシブデザイン — さまざまな画面サイズに対応
スムーズなアニメーション — Framer Motion による
AI 支援ライティング — 完了済みのロードマップ項目として記載
多言語サポート — 完了済みとして記載
PDF、Markdown などのインポート — 完了済みとして記載
カスタムモデル — 完了済みとして記載
自動 1 ページ — 完了済みとして記載

技術スタック

このプロジェクトは以下で構築されています：TanStack Start（React フレームワーク）、TypeScript、Motion（アニメーションライブラリ）、Tiptap（リッチテキストエディタ）、Tailwind CSS（スタイリング）、Zustand（状態管理）、Shadcn/ui（UI コンポーネント）、Lucide Icons。

ローカルでの実行方法

リポジトリをクローン：git clone git@github.com:JOYCEQL/magic-resume.git
依存関係をインストール：pnpm install
開発サーバーを起動：pnpm dev
ブラウザで http://localhost:3000 を開く

デプロイオプション

Docker Compose：プロジェクトルートで docker compose up -d を実行して、コンテナ内でアプリをビルドして起動します。
Cloudflare Workers：サポートされています（ネイティブ fetch を使用、プロキシ不要）。
Node.js/Docker：お住まいの地域で AI プロバイダー（OpenAI、Gemini、Anthropic）に直接アクセスできない場合は、AI_PROXY_URL または HTTPS_PROXY/HTTP_PROXY 環境変数を設定できます。DeepSeek、Qwen、Doubao は常に直接接続を使用します。

オプションの AI プロバイダー：OrcaRouter

AI プロバイダーとして OrcaRouter を選択できます。使用するには、README の紹介リンクから登録し、OrcaRouter でサインインするか、独自の API キーを入力します。README には、これはパートナー紹介リンクであり、Magic Resume は紹介されたサインアップからの適格な使用に対してコミッションを得る可能性があると記載されています。他の AI プロバイダーも引き続き利用可能です。

アプリ使用の帰属用に、オプションの VITE_ORCA_APP_ID ビルド時変数もあります。これは公開アプリ識別子（秘密鍵ではありません）であり、ビルド時に設定する必要があります。実行中のコンテナに設定しても効果はありません。

ライセンスと使用制限

ソースコードは Apache 2.0 でリリースされており、追加の非商用制限が付いています：

個人利用は無料 — 学習、自分の履歴書作成など。
商用利用は禁止 — 有料サービス（SaaS/PaaS）、企業の商用運営、再販、二次的な商用開発は、コードを変更した場合でも禁止されています。

ロードマップの状態

完了： AI 支援ライティング、多言語サポート、追加のエクスポート形式、PDF/Markdown のインポート、カスタムモデル、自動 1 ページ。

未完了： 追加の履歴書テンプレート、オンライン履歴書ホスティング。

プロジェクト詳細

著者： Siyue
連絡先： X (@GuangzhouY81070)、Discord コミュニティ、メール (18806723365@163.com)
ホームページ： https://github.com/JOYCEQL/magic-resume
スポンサー： 2 名記載 — @yj147 と @someone1128

注記

README にはスター履歴チャートと Trendshift バッジが含まれており、プロジェクトにある程度のコミュニティの支持があることを示しています。
README には、履歴書エディタ自体の仕組み（具体的な編集操作など）の詳細な説明はなく、価格、ホストされたデモ URL、詳細な API ドキュメントも記載されていません。