Skip to content

chenxideer/Anime-Artisan-Studio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 

Repository files navigation

๐Ÿง  Aesthetic Intelligence Curator (AIC)

Download

๐ŸŒŒ The Vision: Where Art Meets Algorithm

Aesthetic Intelligence Curator (AIC) is not merely a download utilityโ€”it's a sophisticated digital curator that bridges the gap between algorithmic precision and human artistic appreciation. Designed for enthusiasts, artists, and researchers, AIC intelligently sources, categorizes, and manages visual artโ€”from classical paintings and digital masterpieces to contemporary anime-style illustrationsโ€”based on learned aesthetic principles and user-defined taste profiles.

Imagine a personal gallery assistant that never sleeps, continuously scouring curated sources to build a collection that resonates with your unique sense of beauty. AIC employs machine learning to understand stylistic elements, color theory, composition, and emotional tone, transforming a simple fetch operation into an act of curation.


โœจ Key Capabilities

  • Neural-Aesthetic Filtering: Goes beyond tags. Utilizes lightweight neural models to analyze and select images based on compositional balance, color harmony, and stylistic coherence.
  • Intelligent Source Orchestration: Connects to multiple curated APIs and respectful community sources, deduplicates content, and prioritizes high-fidelity artwork.
  • Dynamic Taste Profile: Your taste evolves, and so does AIC. The tool learns from your interactions (selections, skips, manual ratings) to refine future acquisitions.
  • Multi-Modal Organization: Automatically tags and organizes your library not just by genre or artist, but by mood, palette, era, and inferred narrative elements.
  • Responsive Cross-Platform UI: A clean, adaptive interface built with CustomTkinter provides a seamless experience from desktop to tablet.
  • Polyglot Interface: Offers multilingual support, making art curation accessible across linguistic boundaries.
  • Continuous Operational Support: Designed for reliability with background operation modes and efficient resource management.

๐Ÿš€ Quick Start

Prerequisites

  • Python 3.10 or higher
  • pip package manager

Installation & Launch

  1. Acquire the Application: Download

  2. Install Dependencies: Navigate to the extracted directory and run:

    pip install -r requirements.txt
  3. Launch the Curator:

    python main.py

    Or, use the provided launcher script for your operating system.


๐Ÿงฉ Core Architecture

The application is structured as a modular pipeline, ensuring scalability and clear separation of concerns.

graph TD
    A[User Taste Profile] --> B(UI Layer);
    C[Curated Source APIs] --> D(Intelligent Fetcher & Scraper);
    B -- Configuration & Triggers --> E{Orchestration Engine};
    D -- Raw Art Data --> E;
    E --> F[Aesthetic Analysis Module];
    F --> G{Filter & Match};
    G -->|Matches Profile| H[Local Gallery DB];
    G -->|Does Not Match| I[Discard / Log];
    H --> J[Metadata & Preview Generator];
    J --> K((User Review & Feedback));
    K -.->|Reinforcement Learning| A;
Loading

โš™๏ธ Configuration: Define Your Aesthetic

AIC is driven by a YAML configuration file (profile_config.yaml). This file is your dialogue with the curator.

Example Profile Configuration

profile: "Serene_Futurist"
aesthetic_pillars:
  mood:
    - tranquil
    - contemplative
    - optimistic
    - melancholic
  color_palette:
    dominant: ["cool blue", "steel gray", "soft cyan"]
    accent: ["electric purple", "sunset orange"]
  composition:
    preference: "rule_of_thirds"
    avoid: "extreme_symmetry"
  subjects:
    favored: ["cyberpunk cityscapes", "solitary figures", "organic machinery"]
    excluded: ["hyper-violence", "gore"]

sources:
  - name: "ArtStation_Curated"
    requires_auth: true
    api_key_env: "ARTSTATION_KEY"
  - name: "DeviantArt_Echo"
    categories: ["digital_art", "science_fiction"]
    safety_filter: "strict"

acquisition_settings:
  batch_size: 25
  quality_threshold: 0.85 # ML confidence score
  deduplication: "perceptual_hash"
  storage_path: "./collections/Serene_Futurist"

๐Ÿ–ฅ๏ธ Advanced Console Invocation

While the GUI is comprehensive, power users can leverage direct command-line control for automation and scripting.

Example Console Invocation

python aic_curator.py \
  --profile "./configs/neo_tokyo.yaml" \
  --source "wallhaven" "pixiv" \
  --tags "aesthetic cyberpunk rain night" \
  --operator-mode "silent" \
  --batch 50 \
  --quality 0.9 \
  --output "./wallpapers/$(date +%Y%m%d)" \
  --log-level "DEBUG"

This command instructs AIC to run in a silent, automated mode, fetching 50 high-quality images matching a "neo-tokyo" aesthetic from specified sources, and organizing them into a dated folder.


๐Ÿ“Š Feature Overview

Feature Description Emoji
Smart Curation Engine ML-driven analysis of art based on learned principles, not just keywords. ๐Ÿง 
Taste Profile Evolution The system adapts and refines its selections based on your continuous feedback. ๐ŸŒฑ
Multi-Source Aggregation Fetches from multiple respectful and legal community sources simultaneously. ๐Ÿ”€
Perceptual Deduplication Uses advanced hashing to avoid storing visually identical or overly similar pieces. ๐Ÿงฌ
Metadata Enrichment Automatically generates descriptive metadata (colors, estimated era, possible inspirations). ๐Ÿท๏ธ
Pause/Resume Sessions Long curation sessions can be halted and resumed without data loss. โธ๏ธโฏ๏ธ
Export & Sharing Export your collection or specific sets with generated visual catalogs (PDF/HTML). ๐Ÿ“ค

๐ŸŒ OS Compatibility

AIC is built with cross-platform compatibility as a core tenet.

Operating System Status Notes
Windows 10/11 โœ… Fully Supported Native experience with installer.
macOS (12+) โœ… Fully Supported Optimized for Apple Silicon.
Linux (Ubuntu/Debian/Fedora) โœ… Fully Supported Requires GTK3 dependencies.
ChromeOS (Linux Env.) โš ๏ธ Operational Runs within the Linux container.

๐Ÿ”Œ Integration with AI Services

AIC can enhance its curation capabilities by interfacing with leading AI analysis platforms (optional).

  • OpenAI API Integration: Can be configured to use GPT-4's vision capabilities to generate poetic descriptions, analyze thematic elements, or suggest similar artistic movements for downloaded art.
  • Claude API Integration: Leverages Claude's strong reasoning to create detailed backstories for characters in illustrations or critique composition based on established art theory.

Configuration requires adding your own API keys to the environment variables. See docs/ai_integration.md.


๐Ÿ›ก๏ธ Disclaimer & Ethical Curation

Aesthetic Intelligence Curator (AIC) is a tool designed for personal collection, inspiration, and research. It is the user's sole responsibility to:

  1. Comply with Source Terms: Respect the terms of service, copyright, and licensing rules of every source API or website configured within the tool.
  2. Use Respectfully: Only download content you have the right to acquire. Support artists by using official platforms, purchasing works, or commissioning where possible.
  3. Verify Content: The NSFW/Safety filters and AI classifiers are not infallible. Review curated content, especially when operating in automated modes.
  4. Understand Limitations: The "aesthetic intelligence" is a statistical model of preferences, not a true understanding of art. Its judgments are probabilistic.

The developers assume no liability for misuse of this tool or infringement of third-party rights. Use thoughtfully and ethically.


๐Ÿ“œ License

This project is licensed under the MIT License. This permissive license allows for broad use, modification, and distribution, provided the original copyright and license notice are included.

For the full terms and conditions, see the LICENSE file in the repository.

ยฉ 2026 Aesthetic Intelligence Curator Project Contributors.


๐Ÿš€ Begin Your Curation Journey

Ready to build your intelligent digital gallery?

Download

Keywords for Discovery: AI art curator, intelligent image collection manager, aesthetic-based downloader, machine learning for art organization, personalized gallery assistant, cross-platform art aggregator, taste profile learning software, ethical digital curation tool.

Releases

No releases published

Packages

 
 
 

Contributors