magic-resume README

The project's README from github.com/JOYCEQL/magic-resume. As one markdown file: README.md.

✨ Magic Resume ✨

License TanStack Start Framer Motion

Magic Resume | Trendshift

简体中文 | English

Magic Resume is a modern online resume editor that makes creating professional resumes simple and enjoyable. Built with TanStack Start and Framer Motion, it supports real-time preview and custom themes.

📸 Screenshots

336_1x_shots_so

✨ Features

🛠️ Tech Stack

🚀 Quick Start

  1. Clone the project
git clone [email protected]:JOYCEQL/magic-resume.git
cd magic-resume
  1. Install dependencies
pnpm install
  1. Start development server
pnpm dev
  1. Open browser and visit http://localhost:3000

📦 Build and Deploy

pnpm build

AI provider networking

Cloudflare Workers use the platform's native fetch and do not need an application-level proxy. For Node.js or Docker deployments in regions that cannot directly reach OpenAI, Gemini, or Anthropic, set AI_PROXY_URL. HTTPS_PROXY and HTTP_PROXY are also supported as fallbacks.

AI_PROXY_URL=http://127.0.0.1:7890

DeepSeek, Qwen, and Doubao continue to use a direct connection.

🐳 Docker Deployment

Docker Compose

  1. Ensure you have Docker and Docker Compose installed

  2. Run the following command in the project root directory:

docker compose up -d

This will:

📝 License and Usage Restrictions

The source code of this project is released under the Apache 2.0 license with an additional non-commercial use restriction:

Please see the LICENSE file for detailed terms.

🗺️ Roadmap

📈 Star History

Star History Chart

📞 Contact

You can follow the latest updates via:

🌟 Support

If you find this project helpful, please give it a star ⭐️

❤️ Sponsors

Sponsors

If you sponsored this project but are not listed here, please contact me.

@yj147 @someone1128

magic-resume (JOYCEQL/magic-resume)

Searching Database…

Что это такое?Magic Resume — это бесплатный онлайн-редактор резюме с ИИ, который делает создание профессионального резюме простым и приятным. Он работает на сайте magicv.art, а исходный код доступен на GitHub.
Это сайт, которым пользуются в браузере, или его нужно размещать у себя?И то и другое. Официальная версия доступна на magicv.art, а можно развернуть и у себя: в репозитории есть настройка для Docker и Docker Compose, а также стартовый скрипт для Node.js.
Как запустить его у себя на компьютере?Склонируйте репозиторий, установите зависимости и запустите dev-сервер (скрипт dev запускает vite dev), затем откройте проект в браузере. Для развертывания есть шаг сборки, стартовый скрипт (node server.mjs) и Docker Compose.
Каких ИИ-провайдеров можно к нему подключить?Поддерживаются OpenAI, Gemini и Anthropic, DeepSeek, Qwen и Doubao подключаются напрямую, а также поддерживаются свои (кастомные) модели. В регионах, где нет прямого доступа к провайдерам, можно задать переменные AIPROXYURL или HTTP(S)-прокси.
Где хранятся данные моего резюме?В вашем браузере — редактор автоматически сохраняет всё в локальное хранилище и показывает изменения в реальном времени, поэтому резюме остается на вашем компьютере, а не на сервере с аккаунтами.
Могу ли я использовать его в коммерческих целях, например для платного сервиса резюме?Нет. Код распространяется по лицензии Apache 2.0 с дополнительным ограничением о некоммерческом использовании: для личных целей пользоваться можно бесплатно, но запускать его как платный сервис, SaaS/PaaS, перепродавать или заниматься коммерческой доработкой запрещено, даже с внесением изменений.
На чём он сделан?В основе лежат TanStack Start и TypeScript, для анимаций — Framer Motion, для редактора — Tiptap, для стилей — Tailwind CSS, для управления состоянием — Zustand, а для компонентов — Shadcn/ui и Lucide Icons.
Моё резюме постоянно вылезает на вторую страницу — это поможет?Да — пункт «Auto one page» на дорожной карте отмечен как завершенный, так что редактор может автоматически уместить содержимое на одну страницу.
Могу ли я оформить резюме на свой вкус?Да, есть встроенные пользовательские темы, у интерфейса есть темный режим, а в дорожной карте запланированы дополнительные шаблоны резюме. Верстка адаптивная, так что всё работает и на телефонах.
Creator
JOYCEQL
Size
182.5 MB
Stars
11.1K
Age
2y
Commits · 90 Days