[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"tool-civitai--civitai":3,"similar-civitai--civitai":119},{"id":4,"github_repo":5,"name":6,"description_en":7,"description_zh":8,"ai_summary_zh":9,"readme_en":10,"readme_zh":11,"quickstart_zh":12,"use_case_zh":13,"hero_image_url":14,"owner_login":6,"owner_name":15,"owner_avatar_url":16,"owner_bio":17,"owner_company":18,"owner_location":18,"owner_email":19,"owner_twitter":20,"owner_website":21,"owner_url":22,"languages":23,"stars":57,"forks":58,"last_commit_at":59,"license":60,"difficulty_score":61,"env_os":62,"env_gpu":63,"env_ram":63,"env_deps":64,"category_tags":75,"github_topics":79,"view_count":83,"oss_zip_url":18,"oss_zip_packed_at":18,"status":84,"created_at":85,"updated_at":86,"faqs":87,"releases":118},5682,"civitai\u002Fcivitai","civitai","A repository of models, textual inversions, and more","Civitai 是一个专注于 Stable Diffusion 生态的开源模型共享与协作平台。它旨在解决 AI 绘画领域资源分散、交流困难的痛点，为用户提供一个集中存放和发现各类生成式 AI 资源的场所。在这里，用户可以轻松上传、浏览和下载文本反转（Textual Inversions）、超网络（Hypernetworks）、VAE 以及各类定制模型，并通过评论与反馈机制促进社区内的知识共享与技术迭代。\n\n该平台非常适合 AI 绘画爱好者、数字艺术家、研究人员以及希望部署本地模型库的开发者使用。无论是想要寻找特定风格模型的普通用户，还是希望展示自己训练成果的技术人员，都能在其中找到价值。在技术架构上，Civitai 展现了现代 Web 开发的高水准，前端与后端基于 Next.js 构建，采用 tRPC 实现高效的类型安全 API 通信，并利用 Prisma 搭配 PostgreSQL 数据库确保数据的可扩展性与维护性，同时结合 Cloudflare 存储方案以支撑大规模模型文件的高效分发。作为一个由社区驱动的项目，Civitai 不仅是一个资源仓库，更是一个推动生成式 AI 技术共同进","Civitai 是一个专注于 Stable Diffusion 生态的开源模型共享与协作平台。它旨在解决 AI 绘画领域资源分散、交流困难的痛点，为用户提供一个集中存放和发现各类生成式 AI 资源的场所。在这里，用户可以轻松上传、浏览和下载文本反转（Textual Inversions）、超网络（Hypernetworks）、VAE 以及各类定制模型，并通过评论与反馈机制促进社区内的知识共享与技术迭代。\n\n该平台非常适合 AI 绘画爱好者、数字艺术家、研究人员以及希望部署本地模型库的开发者使用。无论是想要寻找特定风格模型的普通用户，还是希望展示自己训练成果的技术人员，都能在其中找到价值。在技术架构上，Civitai 展现了现代 Web 开发的高水准，前端与后端基于 Next.js 构建，采用 tRPC 实现高效的类型安全 API 通信，并利用 Prisma 搭配 PostgreSQL 数据库确保数据的可扩展性与维护性，同时结合 Cloudflare 存储方案以支撑大规模模型文件的高效分发。作为一个由社区驱动的项目，Civitai 不仅是一个资源仓库，更是一个推动生成式 AI 技术共同进步的开放社区。","[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![Apache License 2.0][license-shield]][license-url]\n[![Discord][discord-shield]][discord-url]\n\n\u003Cbr \u002F>\n\u003Cdiv align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fcivitai.com\u002F\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcivitai_civitai_readme_4b39058e4b6e.png\" alt=\"Civitai Logo\" width=\"120\" height=\"auto\">\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\n## Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [About the Project](#about-the-project)\n  - [Tech Stack](#tech-stack)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n  - [Altering your user](#altering-your-user)\n  - [Known limitations](#known-limitations)\n- [Contributing](#contributing)\n  - [Data Migrations](#data-migrations)\n- [Sponsors](#sponsors)\n- [License](#license)\n\n## About the Project\n\nOur goal with this project is to create a platform where people can share their stable diffusion models (textual inversions, hypernetworks, aesthetic\ngradients, VAEs, and any other crazy stuff people do to customize their AI generations), collaborate with others to improve them, and learn from each\nother's work. The platform allows users to create an account, upload their models, and browse models that have been shared by others. Users can also\nleave comments and feedback on each other's models to facilitate collaboration and knowledge sharing.\n\n### Tech Stack\n\nWe've built this project using a combination of modern web technologies, including Next.js for the frontend, TRPC for the API, and Prisma + Postgres\nfor the database. By leveraging these tools, we've been able to create a scalable and maintainable platform that is both user-friendly and powerful.\n\n- **DB:** Prisma + Postgres\n- **API:** tRPC\n- **Front-end + Back-end:** NextJS\n- **UI Kit:** [Mantine](https:\u002F\u002Fmantine.dev\u002F)\n- **Storage:** Cloudflare\n\n## Getting Started\n\n\u003Cdetails open>\n\u003Csummary>To get a local copy up and running, follow these steps.\u003C\u002Fsummary>\n\n### Prerequisites\n\nFirst, make sure that you have the following installed on your machine:\n\n- [Docker](https:\u002F\u002Fwww.docker.com\u002F) (for running the database and services)\n- If using devcontainers\n    - An IDE that supports them (VS Code with devcontainers extension, Jetbrains, etc.)\n- If running directly\n    - Node.js (version 20 or later)\n        - We recommend you have installed `nvm` in order to set the right node version to run this project\n          ```sh\n          curl -o- https:\u002F\u002Fraw.githubusercontent.com\u002Fnvm-sh\u002Fnvm\u002Fv0.40.1\u002Finstall.sh | bash\n          ```\n    - Make (optional, for easier initial setup)\n\n### Installation\n\n1. Follow the [Prerequisites](#prerequisites) steps above\n2. Clone the repository to your local machine\n3. Choose one method:\n    - a) Use devcontainers\n      > ⚠️ Important Warning for Windows Users: Either clone this repo onto a WSL volume, or use the \"clone repository in named container volume\"\n      command. Otherwise, you will see performance issues.\n        - Open the directory up in your IDE of choice\n            - VS Code should prompt you to \"Open in container\"\n                - If not, you may need to manually run `Dev Containers: Open Folder in Container`\n            - For other IDEs, you may need to open the `.devcontainer\u002Fdevcontainer.json` file, and click \"Create devcontainer and mount sources\"\n            - _Note: this may take some time to run initially_\n        - Run `make run` or `npm run dev`\n    - b) Run `make init`\n        - This command will do a few things:\n            - Creates a starter `env` file\n            - Installs npm packages\n            - Spins up docker containers\n            - Runs any additional database migrations\n            - Creates some dummy seed data\n            - Populates metrics and meilisearch\n            - Initializes prisma\n            - Runs the server\n        - If you see an error about an app not being found, make sure `node_modules\u002F.bin` is added to your path:\n            - `export PATH=\"$PATH:$(realpath node_modules\u002F.bin)\"`\n        - If you are an internal member, you can use the buzz and signals service\n            - Set this up once by creating a personal access token in github (with read package permissions)\n            - Set that to `CR_PAT` env\n            - Run `echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin`\n    - Please report any issues with these commands to us on [discord][discord-url]\n4. Edit the `.env.development` file\n    - Most default values are configured to work out of the box, except the S3 upload key and secret. To generate those, navigate to\n      the minio web interface at [http:\u002F\u002Flocalhost:9000](http:\u002F\u002Flocalhost:9000) with the default username and password `minioadmin`, and then navigate\n      to the \"Access Keys\" tab. Click \"Create Access Key\" and copy the generated key and secret into the `.env` file (`S3_UPLOAD_KEY` and `S3_UPLOAD_SECRET`, `S3_IMAGE_UPLOAD_KEY` and `S3_IMAGE_UPLOAD_SECRET`).\n    - Set `WEBHOOK_TOKEN` to a random string of your choice. This will be used to authenticate requests to the webhook endpoint.\n    - Add a random string of your choice to the email properties to allow user registration\n        - `EMAIL_USER`\n        - `EMAIL_PASS`\n        - `EMAIL_FROM` (Valid email format needed)\n5. Run `git submodule update --recursive`\n6. Finally, visit [http:\u002F\u002Flocalhost:3000](http:\u002F\u002Flocalhost:3000) to see the website.\n\n_* Note that account creation will run emails through maildev, which can be accessed at [http:\u002F\u002Flocalhost:1080](http:\u002F\u002Flocalhost:1080)._\n\n### Altering your user\n\n- First, create an account for yourself as you normally would through the UI.\n- You may wish to set yourself up as a moderator. To do so:\n    - Use a database editor (like [DataGrip](https:\u002F\u002Fwww.jetbrains.com\u002Fdatagrip\u002F)) or connect directly to the\n      DB (`PGPASSWORD=postgres psql -h localhost -p 15432 -U postgres civitai`)\n    - Find your user (by email or username), and change `isModerator` to `true`\n\n### Known limitations\n\nServices that require external input will currently not work locally. These include:\n\n- Orchestration (Generation, Training)\n- Signals (Chat, Notifications, other real-time updates)\n- Buzz\n\n\u003C\u002Fdetails>\n\n## Contributing\n\nAny contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the repository to your own GitHub account.\n2. Create a new branch for your changes.\n3. Make your changes to the code.\n4. Commit your changes and push the branch to your forked repository.\n5. Open a pull request on our repository.\n\nIf you would like to be more involved, consider joining the **Community Development Team**! For more information on the team as well as how to join,\nsee [Calling All Developers: Join Civitai's Community Development Team](https:\u002F\u002Fcivitai.com\u002Farticles\u002F7782).\n\n### Data Migrations\n\nOver the course of development, you may need to change the structure of the database. To do this:\n\n1. Make your changes to the `schema.prisma` file\n2. Create a folder in the `prisma\u002Fmigrations folder` named with the convention `YYYYMMDDHHmmss_brief_description_here`\n3. In this folder, create a file called `migration.sql`\n4. In that file, put your sql changes\n    - These are usually simple sql commands like `ALTER TABLE ...`\n5. Run `make run-migrations` and `make gen-prisma`\n6. If you are adding\u002Fchanging a column or table, please try to keep the `gen_seed.ts` file up to date with these changes.\n\n## Sponsors\n\nSupport this project by becoming a sponsor. Your logo will show up here with a link to your website.\n\n## License\n\nApache License 2.0 - Please have a look at the [LICENSE](\u002FLICENSE) for more details.\n\n\n[contributors-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[contributors-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fgraphs\u002Fcontributors\n\n[forks-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[forks-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fnetwork\u002Fmembers\n\n[stars-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[stars-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fstargazers\n\n[issues-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[issues-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fissues\n\n[license-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[license-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fblob\u002Fmaster\u002FLICENSE\n\n[discord-shield]: https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1037799583784370196?style=for-the-badge\n\n[discord-url]: https:\u002F\u002Fdiscord.gg\u002FUwX5wKwm6c\n","[![贡献者][contributors-shield]][contributors-url]\n[![分支][forks-shield]][forks-url]\n[![星标][stars-shield]][stars-url]\n[![问题][issues-shield]][issues-url]\n[![Apache 2.0 许可证][license-shield]][license-url]\n[![Discord][discord-shield]][discord-url]\n\n\u003Cbr \u002F>\n\u003Cdiv align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fcivitai.com\u002F\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcivitai_civitai_readme_4b39058e4b6e.png\" alt=\"Civitai Logo\" width=\"120\" height=\"auto\">\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\n## 目录\n\n- [目录](#目录)\n- [项目简介](#项目简介)\n  - [技术栈](#技术栈)\n- [快速入门](#快速入门)\n  - [先决条件](#先决条件)\n  - [安装](#安装)\n  - [修改用户权限](#修改用户权限)\n  - [已知限制](#已知限制)\n- [贡献](#贡献)\n  - [数据迁移](#数据迁移)\n- [赞助商](#赞助商)\n- [许可证](#许可证)\n\n## 项目简介\n\n我们的目标是打造一个平台，让人们可以分享自己的 Stable Diffusion 模型（如文本反演、超网络、美学梯度、VAE 等用于定制 AI 生成内容的各种创新方法），与他人协作改进这些模型，并相互学习。该平台允许用户创建账户、上传模型，以及浏览他人分享的模型。用户还可以对彼此的模型发表评论和反馈，以促进协作和知识共享。\n\n### 技术栈\n\n我们使用了一系列现代 Web 技术构建了这个项目，包括 Next.js 作为前端框架、TRPC 作为 API 层，以及 Prisma 和 Postgres 作为数据库。通过这些工具的结合使用，我们成功构建了一个既易于使用又功能强大的可扩展且易于维护的平台。\n\n- **数据库:** Prisma + Postgres\n- **API:** tRPC\n- **前后端:** NextJS\n- **UI 框架:** [Mantine](https:\u002F\u002Fmantine.dev\u002F)\n- **存储:** Cloudflare\n\n## 快速入门\n\n\u003Cdetails open>\n\u003Csummary>要将本地副本运行起来，请按照以下步骤操作。\u003C\u002Fsummary>\n\n### 先决条件\n\n首先，请确保您的机器上已安装以下软件：\n\n- [Docker](https:\u002F\u002Fwww.docker.com\u002F)（用于运行数据库和服务）\n- 如果使用开发容器：\n    - 支持开发容器的 IDE（例如 VS Code 配合 Dev Containers 扩展、JetBrains 等）\n- 如果直接在本地运行：\n    - Node.js（版本 20 或更高）\n        - 建议您安装 `nvm` 来管理 Node.js 版本，以便正确配置运行该项目所需的 Node.js 版本。\n          ```sh\n          curl -o- https:\u002F\u002Fraw.githubusercontent.com\u002Fnvm-sh\u002Fnvm\u002Fv0.40.1\u002Finstall.sh | bash\n          ```\n    - Make（可选，便于初始设置）\n\n### 安装\n\n1. 按照上述【先决条件】中的步骤进行准备。\n2. 将仓库克隆到您的本地机器。\n3. 选择以下其中一种方式：\n    - a) 使用开发容器\n      > ⚠️ Windows 用户重要提示：请将此仓库克隆到 WSL 卷上，或者使用“在命名容器卷中克隆仓库”命令。否则可能会遇到性能问题。\n        - 在您选择的 IDE 中打开项目目录：\n            - VS Code 应会提示您“在容器中打开”。\n                - 如果没有提示，您可以手动运行“Dev Containers: 在容器中打开文件夹”。\n            - 对于其他 IDE，您可能需要打开 `.devcontainer\u002Fdevcontainer.json` 文件，然后点击“创建开发容器并挂载源代码”。\n            - _注意：首次运行可能需要一些时间。_\n        - 运行 `make run` 或 `npm run dev`。\n    - b) 运行 `make init`\n        - 此命令会执行以下操作：\n            - 创建一个基础的 `.env` 文件。\n            - 安装 npm 包。\n            - 启动 Docker 容器。\n            - 执行任何额外的数据库迁移。\n            - 创建一些示例种子数据。\n            - 初始化指标和 MeiliSearch。\n            - 初始化 Prisma。\n            - 启动服务器。\n        - 如果您看到找不到应用程序的错误，请确保将 `node_modules\u002F.bin` 添加到您的 PATH 中：\n            - `export PATH=\"$PATH:$(realpath node_modules\u002F.bin)\"`\n        - 如果您是内部成员，可以使用 Buzz 和信号服务：\n            - 首次设置时，在 GitHub 上创建一个具有读取包权限的个人访问令牌。\n            - 将其设置为环境变量 `CR_PAT`。\n            - 运行 `echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin`。\n    - 如有任何关于这些命令的问题，请在 [Discord][discord-url] 上向我们反馈。\n4. 编辑 `.env.development` 文件。\n    - 大多数默认值已经配置好可以直接使用，但 S3 上传密钥和密钥除外。要生成这些密钥，请访问 Minio 的 Web 界面：[http:\u002F\u002Flocalhost:9000](http:\u002F\u002Flocalhost:9000)，使用默认用户名和密码 `minioadmin` 登录，然后进入“访问密钥”选项卡。点击“创建访问密钥”，并将生成的密钥和密钥复制到 `.env` 文件中（`S3_UPLOAD_KEY` 和 `S3_UPLOAD_SECRET`, `S3_IMAGE_UPLOAD_KEY` 和 `S3_IMAGE_UPLOAD_SECRET`）。\n    - 将 `WEBHOOK_TOKEN` 设置为任意随机字符串。此令牌将用于验证 webhook 端点的请求。\n    - 在电子邮件相关字段中添加任意随机字符串，以启用用户注册功能：\n        - `EMAIL_USER`\n        - `EMAIL_PASS`\n        - `EMAIL_FROM`（需符合有效的电子邮件格式）。\n5. 运行 `git submodule update --recursive`。\n6. 最后，访问 [http:\u002F\u002Flocalhost:3000](http:\u002F\u002Flocalhost:3000) 查看网站。\n\n_* 注意：账户创建过程中会通过 maildev 发送邮件，您可以在 [http:\u002F\u002Flocalhost:1080](http:\u002F\u002Flocalhost:1080) 查看这些邮件。_\n\n### 修改用户权限\n\n- 首先，通过界面正常创建一个账户。\n- 如果您希望将自己设置为版主，请执行以下操作：\n    - 使用数据库编辑工具（如 [DataGrip](https:\u002F\u002Fwww.jetbrains.com\u002Fdatagrip\u002F)）或直接连接到数据库（`PGPASSWORD=postgres psql -h localhost -p 15432 -U postgres civitai`）。\n    - 找到您的用户记录（通过邮箱或用户名），并将 `isModerator` 字段设置为 `true`。\n\n### 已知限制\n\n目前，需要外部输入的服务在本地环境中无法正常运行，包括：\n\n- 编排（生成、训练）\n- 信号（聊天、通知等实时更新）\n- Buzz\n\n\u003C\u002Fdetails>\n\n## 贡献\n\n您所做的任何贡献都**非常感谢**。\n\n如果您有改进建议，请 fork 该仓库并创建一个 pull request。您也可以直接提交一个带有“enhancement”标签的问题。别忘了给项目点个 star！再次感谢！\n\n1. 将仓库 fork 到您自己的 GitHub 账号。\n2. 为您的更改创建一个新的分支。\n3. 对代码进行修改。\n4. 提交更改并将分支推送到您的 fork 仓库。\n5. 在我们的仓库中打开一个 pull request。\n\n如果您希望更深入地参与，可以考虑加入**社区开发团队**！有关团队的更多信息以及如何加入，请参阅 [号召所有开发者：加入 Civitai 社区开发团队](https:\u002F\u002Fcivitai.com\u002Farticles\u002F7782)。\n\n### 数据迁移\n\n在开发过程中，您可能需要更改数据库结构。为此：\n\n1. 修改 `schema.prisma` 文件。\n2. 在 `prisma\u002Fmigrations` 文件夹中创建一个以 `YYYYMMDDHHmmss_简要描述_here` 为命名规范的文件夹。\n3. 在该文件夹中创建一个名为 `migration.sql` 的文件。\n4. 在该文件中编写您的 SQL 更改语句。\n   - 这些通常是简单的 SQL 命令，例如 `ALTER TABLE ...`。\n5. 运行 `make run-migrations` 和 `make gen-prisma`。\n6. 如果您正在添加或更改列或表，请尽量保持 `gen_seed.ts` 文件与这些更改同步。\n\n## 赞助商\n\n通过成为赞助商来支持本项目。您的 logo 将在此处显示，并附带指向您网站的链接。\n\n## 许可证\n\nApache License 2.0 - 请查看 [LICENSE](\u002FLICENSE) 以获取更多详细信息。\n\n\n[contributors-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[contributors-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fgraphs\u002Fcontributors\n\n[forks-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[forks-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fnetwork\u002Fmembers\n\n[stars-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[stars-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fstargazers\n\n[issues-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[issues-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fissues\n\n[license-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fcivitai\u002Fcivitai.svg?style=for-the-badge\n\n[license-url]: https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fblob\u002Fmaster\u002FLICENSE\n\n[discord-shield]: https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1037799583784370196?style=for-the-badge\n\n[discord-url]: https:\u002F\u002Fdiscord.gg\u002FUwX5wKwm6c","# Civitai 开源平台快速上手指南\n\nCivitai 是一个用于分享和协作开发 Stable Diffusion 模型（如 Textual Inversions、Hypernetworks、VAEs 等）的开源平台。本项目基于 Next.js、tRPC、Prisma 和 Postgres 构建。\n\n## 环境准备\n\n在开始之前，请确保您的机器已安装以下依赖：\n\n*   **Docker**: 用于运行数据库和本地服务。\n    *   下载地址：[https:\u002F\u002Fwww.docker.com\u002F](https:\u002F\u002Fwww.docker.com\u002F)\n*   **Node.js**: 版本需为 20 或更高。\n    *   推荐使用 `nvm` 管理 Node 版本：\n        ```sh\n        curl -o- https:\u002F\u002Fraw.githubusercontent.com\u002Fnvm-sh\u002Fnvm\u002Fv0.40.1\u002Finstall.sh | bash\n        ```\n*   **Make** (可选): 用于简化初始设置命令。\n*   **IDE** (可选): 若使用开发容器，推荐 VS Code (需安装 Dev Containers 插件) 或 JetBrains 系列 IDE。\n\n> **Windows 用户注意**: 若使用 Dev Containers，请将代码克隆到 WSL 卷中，或使用\"clone repository in named container volume\"命令，否则会遇到性能问题。\n\n## 安装步骤\n\n### 1. 克隆项目\n将仓库克隆到本地机器：\n```bash\ngit clone \u003Crepository-url>\ncd civitai\n```\n\n### 2. 初始化环境\n您可以选择以下两种方式之一进行启动：\n\n**方式 A：使用 Make 命令（推荐）**\n运行初始化命令，它将自动创建环境变量文件、安装依赖、启动 Docker 容器、执行数据库迁移并生成种子数据：\n```bash\nmake init\n```\n*注：若遇到 \"app not found\" 错误，请执行 `export PATH=\"$PATH:$(realpath node_modules\u002F.bin)\"`。*\n\n**方式 B：使用 Dev Containers**\n*   **VS Code**: 打开文件夹，当提示 \"Open in container\" 时确认，或手动运行 `Dev Containers: Open Folder in Container`。\n*   **其他 IDE**: 打开 `.devcontainer\u002Fdevcontainer.json` 并点击 \"Create devcontainer and mount sources\"。\n*   容器启动后，运行：\n    ```bash\n    make run\n    # 或\n    npm run dev\n    ```\n\n### 3. 配置环境变量\n编辑 `.env.development` 文件：\n\n1.  **配置 S3 存储密钥**:\n    *   访问 [http:\u002F\u002Flocalhost:9000](http:\u002F\u002Flocalhost:9000) (MinIO 界面)。\n    *   登录账号\u002F密码均为 `minioadmin`。\n    *   进入 \"Access Keys\" 标签页，点击 \"Create Access Key\"。\n    *   将生成的 Key 和 Secret 填入 `.env.development` 中的 `S3_UPLOAD_KEY`, `S3_UPLOAD_SECRET`, `S3_IMAGE_UPLOAD_KEY`, `S3_IMAGE_UPLOAD_SECRET`。\n2.  **配置 Webhook**:\n    *   设置 `WEBHOOK_TOKEN` 为任意随机字符串。\n3.  **配置邮件服务 (用于注册)**:\n    *   为 `EMAIL_USER`, `EMAIL_PASS`, `EMAIL_FROM` (需合法邮箱格式) 填入任意随机字符串以启用本地注册功能。\n\n### 4. 更新子模块\n```bash\ngit submodule update --recursive\n```\n\n### 5. 启动验证\n访问 [http:\u002F\u002Flocalhost:3000](http:\u002F\u002Flocalhost:3000) 查看网站。\n*   **邮件预览**: 注册邮件将通过 Maildev 发送，可在 [http:\u002F\u002Flocalhost:1080](http:\u002F\u002Flocalhost:1080) 查看。\n\n## 基本使用\n\n### 1. 创建管理员账户\n1.  在前端页面正常注册一个用户账号。\n2.  通过数据库工具将该用户提升为管理员（Moderator）：\n    *   **方法一 (命令行)**:\n        ```bash\n        PGPASSWORD=postgres psql -h localhost -p 15432 -U postgres civitai\n        ```\n        在 SQL 提示符下执行（替换为您的用户名或邮箱）：\n        ```sql\n        UPDATE \"User\" SET \"isModerator\" = true WHERE username = '您的用户名';\n        -- 或者\n        UPDATE \"User\" SET \"isModerator\" = true WHERE email = '您的邮箱';\n        ```\n    *   **方法二 (GUI 工具)**: 使用 DataGrip 等工具连接数据库 (`localhost:15432`, 用户 `postgres`, 密码 `postgres`, 库 `civitai`)，找到用户表并将 `isModerator` 字段改为 `true`。\n\n### 2. 已知限制\n本地开发环境下，以下依赖外部输入的服务暂时不可用：\n*   编排服务（生成、训练）\n*   信号服务（聊天、通知、实时更新）\n*   Buzz 积分系统\n\n现在您可以开始在本地浏览模型、上传资源并进行开发了。","一位独立游戏开发者正在为项目制作风格统一的 2D 角色立绘，需要快速找到并微调特定的艺术风格模型。\n\n### 没有 civitai 时\n- **资源分散难寻**：开发者需在 Discord 频道、GitHub 仓库和各类论坛中盲目搜索模型，耗时数天也难以找到高质量的特定风格检查点（Checkpoints）。\n- **效果不可预见**：下载模型前无法查看真实的生成样图，往往安装后才发现画风不符或存在严重伪影，导致反复试错。\n- **缺乏参数参考**：即使找到可用模型，也因缺少对应的提示词（Prompts）和生成参数设置，难以复现理想效果，调试成本极高。\n- **版本管理混乱**：不同作者发布的模型版本混杂，缺乏统一的更新通知和用户反馈机制，容易误用过时或有缺陷的版本。\n\n### 使用 civitai 后\n- **一站式精准检索**：直接在 civitai 通过标签、排序和社区评分筛选出高赞的“二次元角色”模型，几分钟内即可锁定目标资源。\n- **所见即所得**：每个模型页都展示了大量带详细参数的生成示例图，开发者可直观判断画风是否匹配，避免无效下载。\n- **一键复用配置**：点击示例图即可直接获取完整的提示词、负面提示词及采样器设置，大幅降低调试门槛，快速产出合格素材。\n- **社区协同优化**：通过评论区与其他用户交流微调技巧，及时获取作者发布的修复补丁，确保始终使用最优模型版本。\n\ncivitai 将分散的 AI 模型资源转化为可信赖、可协作的创作生态，让开发者从繁琐的资源搜集与调试中解放，专注于内容创新。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcivitai_civitai_4b39058e.png","Civitai","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fcivitai_3bcef768.png","",null,"hello@civitai.com","HelloCivitai","https:\u002F\u002Fcivitai.com","https:\u002F\u002Fgithub.com\u002Fcivitai",[24,28,32,36,40,44,47,50,54],{"name":25,"color":26,"percentage":27},"TypeScript","#3178c6",88.7,{"name":29,"color":30,"percentage":31},"PLpgSQL","#336790",5.2,{"name":33,"color":34,"percentage":35},"JavaScript","#f1e05a",3.9,{"name":37,"color":38,"percentage":39},"SCSS","#c6538c",1.3,{"name":41,"color":42,"percentage":43},"Shell","#89e051",0.3,{"name":45,"color":46,"percentage":43},"HTML","#e34c26",{"name":48,"color":49,"percentage":43},"CSS","#663399",{"name":51,"color":52,"percentage":53},"Dockerfile","#384d54",0,{"name":55,"color":56,"percentage":53},"Makefile","#427819",7073,713,"2026-04-08T17:18:50","Apache-2.0",4,"Linux, macOS, Windows","未说明",{"notes":65,"python":63,"dependencies":66},"该项目是一个基于 Next.js 的 Web 平台，而非本地 AI 推理工具，因此不需要 GPU。运行环境主要依赖 Node.js (v20+) 和 Docker。Windows 用户若使用开发容器（devcontainers），需将代码克隆到 WSL 卷或使用特定命令以避免性能问题。部分需要外部输入的服务（如生成、训练、实时信号）在本地运行时不可用。数据库和对象存储（MinIO）通过 Docker 运行，需配置 S3 密钥和邮件服务环境变量才能完整体验注册功能。",[67,68,69,70,71,72,73,74],"Node.js >= 20","Docker","Next.js","tRPC","Prisma","Postgres","Mantine","Make (可选)",[76,77,78],"开发框架","Agent","图像",[80,81,82],"ai","social-network","stable-diffusion",2,"ready","2026-03-27T02:49:30.150509","2026-04-09T05:25:17.684826",[88,93,98,103,108,113],{"id":89,"question_zh":90,"answer_zh":91,"source_url":92},25786,"如何获取某个模型的所有版本信息？API 默认只返回最新版本。","此前 GET \u002Fapi\u002Fv1\u002Fmodels\u002F:modelId 接口确实只返回最新版本信息，但该问题已被修复。现在该 API 应能正确返回包含所有版本详情的数据。如果仍然遇到此问题，请检查是否使用了最新的 API 文档或尝试清除本地缓存。维护者已确认相关修复已上线。","https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fissues\u002F1100",{"id":94,"question_zh":95,"answer_zh":96,"source_url":97},25785,"登录后浏览模型时所有模型都被过滤掉（显示无结果），但登出后正常，如何解决？","这是一个已知的账户特定问题，通常由用户设置冲突或系统故障引起。虽然部分用户报告清除缓存或创建新账户可暂时缓解，但根本解决需要等待官方修复。如果问题持续，建议尝试以下临时方案：1. 清除浏览器 Cookie 和缓存；2. 禁用浏览器扩展程序；3. 尝试使用无痕模式登录。若仍无效，可能需要联系管理员重置账户设置（注意：重置可能会丢失点赞\u002F隐藏记录，但支持者徽章通常会保留）。","https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fissues\u002F269",{"id":99,"question_zh":100,"answer_zh":101,"source_url":102},25787,"为什么收不到模型评论、@提及或回复的通知？","通知失效通常是由于网站后端更新（如模型排名视图重构）导致的临时故障。维护者表示此类问题会在修复后自动恢复，未收到的历史通知可能无法补发，但后续的新互动将正常推送通知。如果遇到此情况，无需额外操作，等待官方修复即可；若长时间未恢复，可检查账户通知设置是否被意外关闭。","https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fissues\u002F150",{"id":104,"question_zh":105,"answer_zh":106,"source_url":107},25788,"上传 SwarmUI 生成的图片时，为什么负向提示词（Negative Prompt）无法被自动识别？","该问题是由于元数据解析器对 SwarmUI 的支持不完善导致的。维护者已通过修改 `src\u002Futils\u002Fmetadata\u002Fswarmui.metadata.ts` 文件修复了此问题。请确保您使用的是最新版本的代码库。如果是在线用户上传，该修复已部署到生产环境；如果是本地开发，请拉取最新代码并重新构建项目。","https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fissues\u002F1392",{"id":109,"question_zh":110,"answer_zh":111,"source_url":112},25789,"SwarmUI 生成的图片上传后，提示词、负向提示词和资源均未自动填充，且被错误识别为 ComfyUI 生成，如何解决？","这是因为元数据处理器注册顺序或逻辑错误导致 SwarmUI 图片被误判。维护者已提交修复补丁，解决了元数据无法读取及资源无法匹配的问题。修复已在周末完成并计划在工作日发布。如果您遇到此问题，请耐心等待官方更新上线；如果是本地部署开发者，可以手动应用相关 commit 或更新到包含该修复的最新版本。","https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fissues\u002F1752",{"id":114,"question_zh":115,"answer_zh":116,"source_url":117},25790,"本地运行 `npm run dev` 时报错 'CLICKHOUSE_TRACKER_URL is invalid' 或 'Invalid environment variables'，如何解决？","这是由于新版本引入了必需的环境变量配置。解决方法有两种：\n1. **推荐方法**：更新代码以包含最新的环境变量修复（参考 PR #1283）。\n2. **临时变通**：在 `.env` 文件中注释掉 `CLICKHOUSE_TRACKER_URL` 和 `SCHEDULER_ENDPOINT`。但对于 `ORCHESTRATOR_ENDPOINT` 和 `ORCHESTRATOR_ACCESS_TOKEN`，由于代码强制校验，注释无效。此时需回退到引入这些变量之前的提交版本（例如 commit `f5687d449f1be6200a2b209c38a04a0b52636815`），或者在代码中暂时移除对 Orchestrator 变量的强制检查。","https:\u002F\u002Fgithub.com\u002Fcivitai\u002Fcivitai\u002Fissues\u002F544",[],[120,130,138,147,155,164],{"id":121,"name":122,"github_repo":123,"description_zh":124,"stars":125,"difficulty_score":126,"last_commit_at":127,"category_tags":128,"status":84},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[77,76,78,129],"数据工具",{"id":131,"name":132,"github_repo":133,"description_zh":134,"stars":135,"difficulty_score":126,"last_commit_at":136,"category_tags":137,"status":84},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[76,78,77],{"id":139,"name":140,"github_repo":141,"description_zh":142,"stars":143,"difficulty_score":83,"last_commit_at":144,"category_tags":145,"status":84},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",145895,"2026-04-08T11:32:59",[76,77,146],"语言模型",{"id":148,"name":149,"github_repo":150,"description_zh":151,"stars":152,"difficulty_score":83,"last_commit_at":153,"category_tags":154,"status":84},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[76,78,77],{"id":156,"name":157,"github_repo":158,"description_zh":159,"stars":160,"difficulty_score":83,"last_commit_at":161,"category_tags":162,"status":84},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[163,76],"插件",{"id":165,"name":166,"github_repo":167,"description_zh":168,"stars":169,"difficulty_score":126,"last_commit_at":170,"category_tags":171,"status":84},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[146,78,77,76]]