Skip to content

Rayinf/liquid-art

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🍸 Liquid Art: The AI Mixology Laboratory / AI 调酒实验室 👾

License: MIT Gemini Pixel Art

English | 中文


🕹️ Features (English)

🧠 The AI Bartender (GenAI Core)

  • Abstract Transcription: Transform abstract prompts like "Tokyo Rain" or "Neon Moonlight" into precise, ingredient-driven recipes.
  • Gemini 2.0 Powered: Leverages the latest Gemini models for nuanced flavor profile analysis and poetic descriptions.
  • Atomic Decomposition: Every AI recipe is parsed into discrete, system-standard actions (pours, shakes, stirs) for a 1:1 simulation experience.

🥃 High-Fidelity Physics Simulator

  • Pixel-Perfect Fluid Dynamics: A custom-built SVG simulation engine that mimics liquid behavior with a "stepped" pixel-art aesthetic.
  • Interactive Workbench: Manual mixing mode where you control every drop. Add ice, shake for intensity, or garnish with blocky delicacies.
  • Flavor Analytics: Real-time feedback on your drink's profile—Sweet, Sour, Bitter, Spicy, Boozy, and Salty.

📼 Cyber-Retro UI/UX

  • CRT Aesthetics: Integrated scanline effects, coordinate grids, and technical overlays for a 1980s lab feel.
  • Technical Telemetry: Real-time "Sensor Data" readouts including TEMP, FLOW, and GPS coordinates during the mixing process.
  • Status Terminal: A CLI-style "Timeline" that logs every action in your mixology sequence.

🕹️ 功能特性 (中文)

🧠 AI 调酒师 (GenAI 核心)

  • 抽象转译:将“东京的雨”或“霓虹月光”等抽象提示词转化为精准的配方。
  • Gemini 2.0 驱动:利用最新的 Gemini 模型进行细腻的风味分析和诗意的文字描述。
  • 原子化拆解:每一份 AI 配方都会被分解为离散的标准动作(倒入、摇晃、搅拌),实现 1:1 的模拟体验。

🥃 高保真物理模拟器

  • 像素级流体动力学:自定义 SVG 模拟引擎,以“阶梯式”像素艺术美学模拟液体行为。
  • 交互式工作台:手动调酒模式,精准控制每一滴流量。可以加入冰块、控制摇晃强度,或添加方块化的装饰物。
  • 风味分析:实时反馈酒水的口味特征——酸、甜、苦、辣、烈、咸。

📼 赛博复古 UI/UX

  • CRT 视觉效果:集成了扫描线、坐标网格和技术叠加层,营造 80 年代实验室质感。
  • 技术遥测:调酒过程中实时显示温度 (TEMP)、流量 (FLOW) 和 GPS 坐标等模拟传感器数据。
  • 状态终端:CLI 风格的“时间轴”记录您调酒序列中的每一个动作。

🚀 Getting Started / 快速上手

Prerequisites / 前提条件

Installation / 安装步骤

  1. Clone the Repo / 克隆仓库:

    git clone https://github.com/Rayinf/liquid-art.git
    cd liquid-art
  2. Install Dependencies / 安装依赖:

    npm install
  3. Launch the Lab / 启动实验室:

    npm run dev
  4. Configure API Access / 配置 API: Open the app, click the Settings (Gear Icon), and paste your Gemini API Key. / 打开应用,点击右上角设置(齿轮图标),粘贴您的 Gemini API Key。


🛠️ Tech Stack / 技术栈

  • Frontend: React + TypeScript
  • Styling: Vanilla CSS (Pixel-Art Theme)
  • AI Service: @google/genai (Gemini SDK)
  • Build Tool: Vite
  • Simulation: Custom SVG Logic

🎨 Aesthetic Guidelines / 视觉规范

Liquid Art follows a strict Retro-Industrial Pixel aesthetic: / Liquid Art 遵循严格的复古工业像素美学:

  • Typography / 字体: Silkscreen for UI elements, Press Start 2P for high-impact headers.
  • Resolution / 分辨率: Intentionally low-res SVG geometry to maintain the "stepped" look. / 刻意采用低分辨率 SVG 几何图形以保持“阶梯感”。
  • Color Palette / 色板: High-contrast, vibrant neons against a deep slate industrial background. / 深色工业背景与高对比度的霓虹色彩。

📜 License / 许可

Distributed under the MIT License. / 基于 MIT 许可证发行。


"Crafting Digital Soul in Every Pixel." / "在每一个像素中铸就数字灵魂。"

Powered By Antigravity

About

GEMINI驱动的赛博酒馆

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors