当前位置：首页 > news >正文

Starry Night Art Gallery部署指南：Python 3.9+环境配置与Streamlit Hack技巧

news 2026/8/7 0:11:54

Starry Night Art Gallery部署指南：Python 3.9+环境配置与Streamlit Hack技巧

1. 环境准备与快速部署

Starry Night Art Gallery是一个基于Streamlit的高端AI艺术生成平台，需要特定的Python环境才能正常运行。以下是详细的部署步骤。

1.1 系统要求与Python版本

首先确保你的系统满足以下要求：

操作系统：Windows 10/11, macOS 10.15+, 或 Ubuntu 18.04+
Python版本：Python 3.9 或更高版本（推荐Python 3.10）
内存：至少8GB RAM（推荐16GB）
显卡：支持CUDA的NVIDIA显卡（推荐RTX 3060以上）
磁盘空间：至少10GB可用空间

检查Python版本的方法：

python --version # 或 python3 --version

如果版本不符合要求，建议从Python官网下载最新版本。

1.2 创建虚拟环境

为了避免依赖冲突，建议使用虚拟环境：

# 创建虚拟环境 python -m venv starry_night_env # 激活虚拟环境 # Windows starry_night_env\Scripts\activate # macOS/Linux source starry_night_env/bin/activate

1.3 安装核心依赖

安装必要的Python包：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 pip install streamlit diffusers transformers accelerate safetensors pip install deep-translater pillow requests

2. Streamlit界面深度定制技巧

Starry Night Art Gallery对Streamlit进行了深度美化，以下是关键的CSS Hack技巧。

2.1 移除原生Streamlit元素

通过CSS注入移除Streamlit的工业感元素：

# 在Streamlit应用开头添加以下代码 hide_streamlit_style = """ <style> #MainMenu {visibility: hidden;} footer {visibility: hidden;} header {visibility: hidden;} .stDeployButton {display:none;} #stDecoration {display:none;} </style> """ st.markdown(hide_streamlit_style, unsafe_allow_html=True)

2.2 黄金渐变与深海墨蓝主题

实现文艺复兴美学的CSS代码：

/* 主要按钮样式 */ .stButton > button { background: linear-gradient(135deg, #FFD700 0%, #D4AF37 100%); color: #0A0A2A; border: none; border-radius: 8px; padding: 12px 24px; font-family: "Ma Shan Zheng", serif; font-weight: bold; } /* 滑块样式 */ .stSlider > div > div > div { background: linear-gradient(90deg, #0A0A2A 0%, #1E3A8A 100%); } /* 文本输入框 */ .stTextInput > div > div > input { background-color: #0A0A2A; color: #FFD700; border: 1px solid #D4AF37; }

2.3 自定义字体集成

集成书法字体提升艺术感：

# 加载自定义字体 font_style = """ <style> @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&display=swap'); * { font-family: 'Ma Shan Zheng', 'Times New Roman', serif; } </style> """ st.markdown(font_style, unsafe_allow_html=True)

3. 核心功能配置与优化

3.1 Kook Zimage Turbo引擎配置

正确配置艺术生成引擎：

from diffusers import AutoPipelineForText2Image import torch # 初始化艺术生成管道 pipe = AutoPipelineForText2Image.from_pretrained( "kook-ai/zimage-turbo", torch_dtype=torch.bfloat16, # 使用BF16精度防止黑图 variant="fp16", use_safetensors=True ) # 启用CPU卸载节省显存 pipe.enable_model_cpu_offload() pipe.enable_attention_slicing()

3.2 内存优化技巧

防止内存泄漏和优化性能：

import gc def generate_art(prompt, steps=12, cfg_scale=2.0): try: # 生成图像 image = pipe( prompt=prompt, num_inference_steps=steps, guidance_scale=cfg_scale, height=1024, width=1024 ).images[0] return image finally: # 清理内存 gc.collect() torch.cuda.empty_cache()

3.3 自动翻译功能集成

实现中文到英文的艺术提示词转换：

from deep_translator import GoogleTranslator def translate_chinese_to_art_prompt(chinese_text): """ 将中文描述转换为艺术英文提示词 """ translation = GoogleTranslator(source='zh-CN', target='en').translate(chinese_text) # 添加艺术风格修饰词 art_keywords = "masterpiece, best quality, fine details, renaissance art, oil painting" return f"{translation}, {art_keywords}"

4. 完整部署示例

4.1 主应用程序代码

创建一个完整的Streamlit应用：

import streamlit as st import torch from diffusers import AutoPipelineForText2Image from deep_translator import GoogleTranslator import gc # 页面配置 st.set_page_config( page_title="Starry Night Art Gallery", page_icon="🎨", layout="wide", initial_sidebar_state="collapsed" ) # 应用自定义CSS def load_css(): with open("styles.css", "r") as f: st.markdown(f"<style>{f.read()}</style>", unsafe_allow_html=True) # 初始化模型 @st.cache_resource def load_model(): pipe = AutoPipelineForText2Image.from_pretrained( "kook-ai/zimage-turbo", torch_dtype=torch.bfloat16, variant="fp16", use_safetensors=True ) pipe.enable_model_cpu_offload() pipe.enable_attention_slicing() return pipe # 主应用 def main(): load_css() pipe = load_model() st.title("🎨 Starry Night Art Gallery") # 输入区域 col1, col2 = st.columns([2, 1]) with col1: prompt = st.text_area("输入你的艺术灵感（支持中文）", height=100) with col2: steps = st.slider("生成步数", 8, 20, 12) cfg_scale = st.slider("创意强度", 1.0, 5.0, 2.0, 0.1) if st.button("生成艺术作品", type="primary"): if prompt: with st.spinner("正在创作中..."): # 翻译中文提示词 if any('\u4e00' <= char <= '\u9fff' for char in prompt): prompt = translate_chinese_to_art_prompt(prompt) # 生成图像 image = generate_art(pipe, prompt, steps, cfg_scale) st.image(image, caption="你的艺术作品", use_column_width=True) # 清理内存 gc.collect() torch.cuda.empty_cache() else: st.warning("请输入艺术灵感描述") if __name__ == "__main__": main()

4.2 样式文件示例

创建styles.css文件：

/* 全局样式 */ .stApp { background: linear-gradient(135deg, #0A0A2A 0%, #1E1E3A 100%); color: #FFD700; } /* 标题样式 */ h1, h2, h3 { color: #FFD700; font-family: "Ma Shan Zheng", serif; text-shadow: 2px 2px 4px rgba(0,0,0,0.5); } /* 按钮悬停效果 */ .stButton > button:hover { background: linear-gradient(135deg, #D4AF37 0%, #FFD700 100%); transform: translateY(-2px); box-shadow: 0 4px 8px rgba(212, 175, 55, 0.3); }

5. 常见问题解决

5.1 内存不足问题

如果遇到内存不足错误，尝试以下解决方案：

# 进一步优化内存使用 pipe.enable_sequential_cpu_offload() # 更激进的内存优化 pipe.enable_xformers_memory_efficient_attention() # 使用xformers优化注意力机制 # 减少图像尺寸 image = pipe( prompt=prompt, num_inference_steps=steps, guidance_scale=cfg_scale, height=512, # 降低分辨率 width=512 ).images[0]

5.2 生成质量优化

调整参数获得更好效果：

# 高质量生成参数 high_quality_params = { "num_inference_steps": 15, # 增加步数 "guidance_scale": 2.5, # 适当提高引导强度 "height": 1024, "width": 1024 }

5.3 网络问题解决

如果下载模型遇到问题：

# 使用国内镜像源 pipe = AutoPipelineForText2Image.from_pretrained( "kook-ai/zimage-turbo", torch_dtype=torch.bfloat16, variant="fp16", use_safetensors=True, cache_dir="./models", # 指定缓存目录 resume_download=True # 支持断点续传 )