How jiaxuanliu-arsko/vaspilot works
VASPilot automates materials-science calculations through web-submitted tasks, CrewAI agents, and MCP calculation tools. The main workflow plans a study, obtains structure/input support, runs and monitors VASP jobs, then stores and presents results. The README also describes Materials Project access, JSON RAG, plotting, memory, and both Flask and Quart interfaces. Several implementation details are documented but not visible in the sampled excerpts; those links are omitted or marked unverified rather than inferred as calls.
Main entry points: vasp_crew.py Crew orchestration · mcp_server.py MCP tool server · flask_server.py Flask server · quart_server.py Quart server
Components 17
Task interface
- Flask server
src/vaspilot/server/flask_server/flask_server.py - Quart server
src/vaspilot/server/quart_server/quart_server.py - Event listener
src/vaspilot/listener/server_listener.py
Agent orchestration
- Crew orchestration
src/vaspilot/crew/vasp_crew.py - Local LLM client
src/vaspilot/crew/local_llm.py - Calculation polling
src/vaspilot/tools/wait_calc_tool.py
Calculation services
- MCP tool server
src/vaspilot/tools/mcp/mcp_server.py - Structure tools
src/vaspilot/tools/mcp/struct_tools.py - VASP calculations
src/vaspilot/tools/mcp/vasp_calculate.py - Plot execution
src/vaspilot/tools/mcp/python_plot.py - Calculation records
src/vaspilot/tools/mcp/sqlite_database.py
Knowledge and memory
- JSON RAG tools
src/vaspilot/tools/json_rag_tool.py - Embedding client
src/vaspilot/crew/embedding.py
Other components
- Researcher
- LLM service
- Materials Project
- Slurm scheduler
Connections 19
- Researcher → Quart server: submits task
README.md - Researcher → Flask server: submits task
README.md - Quart server → Crew orchestration: starts workflow
- Flask server → Crew orchestration: starts workflow
- Crew orchestration → Local LLM client: uses model
src/vaspilot/crew/vasp_crew.py - Local LLM client → LLM service: requests completions
src/vaspilot/crew/local_llm.py - Crew orchestration → JSON RAG tools: configures tools
src/vaspilot/crew/vasp_crew.py - Crew orchestration → Embedding client: configures embeddings
src/vaspilot/crew/vasp_crew.py - JSON RAG tools → Embedding client: embeds queries
- Crew orchestration → Calculation polling: configures tool
src/vaspilot/crew/vasp_crew.py - Calculation polling → MCP tool server: checks status
src/vaspilot/tools/wait_calc_tool.py - MCP tool server → Structure tools: dispatches tools
src/vaspilot/tools/mcp/mcp_server.py - MCP tool server → VASP calculations: dispatches calculations
src/vaspilot/tools/mcp/mcp_server.py - MCP tool server → Plot execution: executes plots
src/vaspilot/tools/mcp/mcp_server.py - MCP tool server → Calculation records: reads and writes
src/vaspilot/tools/mcp/mcp_server.py - VASP calculations → Slurm scheduler: submits jobs
- Structure tools → Materials Project: retrieves structures
- Quart server → Event listener: registers events
src/vaspilot/server/quart_server/quart_server.py - Flask server → Event listener: registers events
src/vaspilot/server/flask_server/flask_server.py