| # Code for the Paper titled ["Perpetual Misogyny: How Gendered Tropes Shape Text-To-Image AI Personalization"](http://arxiv.org/pdf/2505.04600) |
|
|
|
|
|
|
|
|
| ### Repository Structure |
|
|
| ``` |
| CIVITAI_VISUALIZATIONS/ |
| ├── .virtual_documents/ # Temporary files from Jupyter |
| ├── data/ # Final curated datasets |
| │ ├── subset1/ # Specific data splits or versions |
| │ ├── subset2/ |
| │ └── ... |
| ├── misc/ |
| │ └── credentials/ # API keys and sensitive config (excluded from versioning) |
| ├── plots/ # Output plots and figures used in the paper |
| ├── ├── jupyter_notebooks/ # Main analysis notebooks |
| │ ├── 0_Scraping_image_metadata.ipynb # Scrapes CivitAI metadata via API |
| │ ├── Section_1_Figure_1_image_grid.ipynb # Grid of sample images |
| │ ├── Section_3-2-1_Figure_3_histogram.ipynb # Histogram of upload trends |
| │ ├── Section_3-2-1_Figure_4_Mivolo.ipynb # Model activity plot (Mivolo-focused) |
| │ ├── Section_3-3-1_Figure_5_tags.ipynb # Tag frequency and usage visualizations |
| │ ├── Section_3-3-3_download_popular_models.ipynb # Download models for analysis |
| │ ├── Section_3-3-3_Figure_6.ipynb # Promotional tag usage patterns |
| │ ├── Section_3-3-4_Figure_8a.ipynb # Ranking of popular models |
| │ ├── Section_3-3-4_Figure_8b.ipynb # Continuation of model rankings |
| │ ├── Section_3-3-4_Figure_9_Sankey.ipynb # Sankey diagram: user-model contributions |
| │ ├── Section_3-3-4_LLM_annotation.ipynb # Annotations using large language models |
| │ ├── Section_3-4_extract_LoRA_metadata.ipynb # LoRA metadata extraction |
| │ ├── SuppM_Figure_12_Danbooru_Taxonomy.ipynb # Danbooru tag taxonomy: visualization |
| │ ├── SuppM_Figure_13_Danbooru_taxonomy.ipynb # Tag grouping and structure |
| │ └── SuppM_Figure_13.ipynb # Supplementary figure generation |
| ├── misc/ # Utility scripts and API credentials (excluded) |
| ├── plots/ # Output plots and visualizations |
| ├── public/ # Optional public-facing files |
| ├── .gitignore |
| ├── .gitmodules |
| ├── README.md # This file |
| └── requirements.txt # Python dependencies |
| ``` |
|
|
| # Project Setup |
|
|
| ## Requirements |
| This project requires Python 3.8 or higher. Ensure you have it installed before proceeding. |
|
|
| ## Installation |
|
|
| 1. **Clone the Repository** |
| ```sh |
| git clone https://gitlab.uzh.ch/latent-canon/pm-paper.git |
| cd pm-paper |
| ``` |
|
|
| 2. **Create a Virtual Environment** |
| (Recommended to avoid dependency conflicts) |
| ```sh |
| python -m venv venv |
| source venv/bin/activate # On macOS/Linux |
| venv\Scripts\activate # On Windows |
| ``` |
|
|
| 3. **Install Dependencies** |
| ```sh |
| pip install -r requirements.txt |
| ``` |
|
|
| 4. **Jupyter Notebook Setup (Optional)** |
| If running Jupyter notebooks, ensure the environment is linked: |
| ```sh |
| python -m ipykernel install --user --name=venv --display-name "Python (venv)" |
| ``` |
|
|
| ## Notes |
| - Ensure you have necessary system dependencies installed (e.g., `opencv` may require additional system libraries). |
| - If you encounter any issues, ensure you're using the correct Python environment (`venv` activated). |
|
|
|
|
