ChemAnim

Convierte requisitos de animaciones químicas en chino a escenas de Manim verificables: DeepSeek se encarga de comprender los requisitos y proporcionar nombres estándar en inglés y SMILES isoméricos candidatos; el programa consulta PubChem, compara las estructuras candidatas mediante huellas dactilares de Morgan, adopta la estructura de la base de datos, y RDKit verifica la fórmula molecular, la carga formal y la conservación de la ecuación. Manim solo lee el JSON final y no ejecuta código generado por el modelo.

Preparación

Se requiere Python 3.12 y una clave de API de DeepSeek. Las ecuaciones se muestran con subíndices químicos Unicode, sin depender de MiKTeX. Instalación inicial:

cd C:\Users\i\Documents\chemenv
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

No escribas la clave en el código fuente ni en .env. Establézcala en la sesión actual de PowerShell:

$secureKey = Read-Host "DeepSeek API Key" -AsSecureString
$env:DEEPSEEK_API_KEY = [Net.NetworkCredential]::new("", $secureKey).Password

Para conservarla en nuevas terminales, agregue DEEPSEEK_API_KEY a las variables de entorno de usuario de Windows y vuelva a abrir PowerShell. Verifique el entorno:

.\check_environment.ps1

Related MCP server: ChemCP

Uso

Primero genere y verifique únicamente la escena, el diagrama de estructura y el informe de verificación:

.\.venv\Scripts\chemanim.exe "演示乙烯与溴的加成反应。生成物为1,2-二溴乙烷，展示所有物质的结构式。" --no-render

Renderice la animación en 2D o 3D:

.\.venv\Scripts\chemanim.exe "演示乙烯与溴的加成反应。生成物为1,2-二溴乙烷。" --quality high
.\.venv\Scripts\chemanim.exe "演示乙烯与溴的加成反应。生成物为1,2-二溴乙烷。" --quality high --structure-mode 3d

--structure-mode 3d habilita automáticamente OpenGL/GPU por defecto; la estructura 2D usa Cairo, más compatible, por defecto. Para una vista previa rápida, se recomienda --quality medium; si necesita selección manual, agregue --renderer opengl o --renderer cairo.

El modo 2D hace que las fórmulas estructurales en la misma escena compartan la misma escala, evitando que las moléculas pequeñas se amplíen forzosamente al mismo ancho que las moléculas complejas.

La salida se encuentra en:

• build/scene.json: escena final y resumen de verificación

• build/verification.json: CID de PubChem, InChIKey, SMILES candidatos/verificados y similitud de Tanimoto de Morgan

• build/molecule_*.svg o datos de átomos/enlaces 3D en la escena

• media/: videos de Manim

El flujo reintenta automáticamente hasta tres veces cuando el JSON de DeepSeek no es válido. Si PubChem no está disponible temporalmente, se conservan las estructuras candidatas y se realiza la verificación local con RDKit; si no se supera la verificación, se detiene y no se renderizan resultados incorrectos.

Por defecto se usa deepseek-v4-flash, que responde más rápido; la estructura química sigue siendo verificada por PubChem y RDKit. Si se necesita una planificación más sólida, agregue --model deepseek-v4-pro --request-timeout 180.

Más ejemplos

.\.venv\Scripts\chemanim.exe "演示甲苯被氧气选择性氧化为苯甲醛和水，展示全部结构式。" --quality medium
.\.venv\Scripts\chemanim.exe "制作阿莫西林半合成原理动画，保持正确立体化学，不要虚构实验条件。" --no-render

Servidor MCP

El proyecto proporciona una entrada MCP estándar de stdio:

.\.venv\Scripts\chemanim-mcp.exe

Ejemplo de configuración del cliente MCP (la clave la hereda el proceso del cliente, no la escriba en el JSON):

{
  "mcpServers": {
    "chemanim": {
      "command": "C:\\Users\\i\\Documents\\chemenv\\.venv\\Scripts\\chemanim-mcp.exe"
    }
  }
}

El servidor expone la herramienta generate_chemistry_animation, cuyos parámetros incluyen prompt, quality, structure_mode, render, model y request_timeout. Solo invoca la CLI de ChemAnim restringida y no ejecuta código Python enviado por el modelo.