Skip to main content
AI tutorials

Whale Girl Open-Source Asset Library Guide: Browse Assets, Preview Locally, and Contribute

This guide covers the Whale Girl open-source asset library, including online usage, local preview, directory structure, contribution channels, GitHub Pages deployment, and licensing considerations for different resource types.

About 18 min read
Whale Girl open-source asset library guide

Project Overview

The Whale Girl open-source asset library is an unofficial resource website maintained by the community. It brings together Whale Girl character reference images, generation prompts, community projects, tools, reference materials, derivative works, and memes. Its goal is to lower the barrier to finding and sharing resources, making it easier for creators to produce derivative works.

Whale Girl open-source asset library

This project does not represent the official position of DeepSeek or DeepSeek's parent company. Whale Girl is a community-created character that continues to evolve. The library provides references only and does not define a single or standardized characterization.

If you only want to browse the resources, visit the Whale Girl open-source asset library website. For project background, see the project FAQ.

Key Content and Features

  • Character creation references: Character design images and ready-to-copy generation prompts.
  • Related resource directory: Whale Girl community projects, creative tools, and reference materials.
  • Community gallery: Community derivative works and memes.
  • Low-barrier contributions: Non-programmers can submit works, recommend resources, or report issues through GitHub forms.
  • Static website structure: Website source files are集中 in site/ and can be previewed locally with a simple Python HTTP server.
  • Automatic deployment: After changes are pushed to the main branch, GitHub Actions automatically deploys site/ to GitHub Pages.

How to Use the Website

Step 1: Open the Resource Website

Open the online site to browse the resources and community gallery on the home page. No software installation is needed to view or copy existing content.

Step 2: Find Creative References

Use the character designs and generation prompts according to your creative needs. Design images are useful for studying character elements, while prompts can be copied directly and adjusted for your own goals. Since the project does not define a single characterization, treat these materials as community references rather than mandatory standards.

Step 3: Verify Asset Licenses

Before quoting or republishing an image, check the corresponding author's notes and licensing terms. A resource being included on the website does not mean the website owns its copyright or that users automatically receive permission to reuse it.

Local Installation and Preview

This is a static website and does not require complex dependencies or build tools. The README specifies that Python 3 must be installed locally.

1. Get the Repository Files

You can download the repository archive from GitHub or clone the project with Git:

git clone https://github.com/TreapGoGo/deepseek-whale-girl.git
cd deepseek-whale-girl

2. Start the Local Server

Run the following command from the repository root:

python -m http.server 4173 --directory site

This command uses Python's built-in HTTP server, sets site/ as the website directory, and listens on port 4173 on the local machine.

3. Open the Preview

After the server starts, visit the following address in a browser:

http://localhost:4173

After modifying HTML, CSS, or JavaScript files, refresh the browser to view the changes. When finished, press Ctrl+C in the terminal running the server to stop it.

Repository Structure

.
├── .github/
│   ├── ISSUE_TEMPLATE/
│   └── workflows/pages.yml
├── characters/
└── site/
    ├── assets/
    ├── index.html
    ├── project.html
    ├── contribute.html
    ├── styles.css
    └── script.js
  • .github/ISSUE_TEMPLATE/: Community artwork, resource recommendation, and feedback forms.
  • .github/workflows/pages.yml: GitHub Pages automatic deployment workflow.
  • characters/: Original archives of character designs and brand assets.
  • site/assets/: Website images and community gallery assets.
  • site/index.html: Website home page and resource gallery.
  • site/project.html: Project FAQ page.
  • site/contribute.html: Contribution guide.
  • site/styles.css: Page styles.
  • site/script.js: Page interaction logic.

Basic Modification Examples

Adjust Page Content

To modify the home page text or resource display, start with site/index.html. The FAQ and contribution guide are located in site/project.html and site/contribute.html, respectively.

  1. Edit the target HTML file.
  2. To adjust the visual style, modify site/styles.css.
  3. To adjust existing page interactions, inspect and modify site/script.js.
  4. Start the local server with the Python command.
  5. Refresh the browser and check that the layout, content, and links work correctly.

Manage Image Assets

Images used by the pages and community gallery are located in site/assets/. Original archives of character designs and brand assets are located in characters/. When changing image references, also verify the file path, source information, and licensing notes.

Contribute Without Programming

The project provides GitHub Issue forms for different types of contributions. Selecting the appropriate channel helps maintainers process submissions more quickly:

When submitting, clearly state the name, source, author, and licensing information for the work or resource. This helps maintainers verify the submission and reduces the risk of later users misunderstanding the scope of the license.

Improve the Website with a Pull Request

Contributors familiar with web development can modify the website directly and submit a Pull Request. A reliable workflow is:

  1. Modify the webpages, styles, or scripts under site/ in a separate branch.
  2. Run the local HTTP server to preview the changes.
  3. Check the page display on desktop and common browsers.
  4. Verify each new or modified link.
  5. Explain the purpose, scope, and verification results in the Pull Request.

Deployment and Advanced Tips

Understand the Automatic Deployment Scope

The project's deployment directory is site/. When updates are pushed to the main branch, GitHub Actions automatically deploys the site to GitHub Pages. You can also manually trigger a deployment from the repository's Actions page.

If original archive files are located in characters/ but are not copied or referenced in site/, do not assume they will automatically appear on the deployed website. Before making changes, distinguish the original asset directory from the actual website directory.

Perform Minimal Checks Before Submission

  • Confirm that the local home page opens at http://localhost:4173.
  • Check the links between the home page, FAQ, and contribution pages.
  • Confirm that new image paths match the filenames.
  • Make sure page interactions still work after JavaScript changes.
  • Check asset sources, author attribution, and licensing information.
  • Explain the reason for the changes in a clear commit message.

Distinguish Between Licenses

The website source code in this repository is released under the MIT License. The website's original explanatory text and generation prompts are shared under CC BY-SA 4.0.

Character designs, community submissions, and materials from external projects are not covered by the code licenses above. They each follow the licensing terms provided by their authors or sources. If a file has separate licensing information, follow the terms specified in that file.

Do not assume that an image can be freely copied, modified, or used in another project simply because it appears in the repository or on the website. Verify the specific license before using it.

Summary

The Whale Girl open-source asset library is both a central source for character references and generation prompts and a platform for sharing community works, tools, and materials. Ordinary users can browse online and contribute through forms, while developers only need Python 3 to preview and modify the static website locally. Regardless of how you participate, respect the community-created nature of the project and carefully verify the copyright and licensing of every asset.