Getting Started

Welcome to Surfacia! This section will help you get up and running with surface-based feature engineering and interpretable machine learning.

• Installation
  • Requirements
  • Install Surfacia
  • Compatibility Note (Important)
  • Quick Verification
  • Next
• Quick Start
  • Prerequisites
  • 5-Minute Tutorial
  • Understanding the Output
  • Common Workflows
  • Individual Commands
  • Performance Tips
  • Troubleshooting
  • Next Steps
• Basic Concepts
  • The Interpretability Problem
  • Why Surfacia Focuses on Molecular Surfaces
  • Key Surface Properties
  • Multi-Scale Descriptor Design
  • Choosing the Right Analysis Mode
  • The Workflow in Plain Language
  • Compact Models, Not Just Large Feature Matrices
  • Descriptor Naming Guide
  • What Makes Surfacia Different
  • Next Steps

Overview

Surfacia is designed to bridge the interpretability gap in computational chemistry by providing:

• Surface-based molecular descriptors that encode chemical reactivity

• Interpretable machine learning with SHAP-based explanations

• Automated workflows from SMILES to predictions

• AI-assisted interpretation through language model integration

What Makes Surfacia Different?

Traditional molecular descriptors often lack direct chemical meaning, making it difficult to understand why certain molecular modifications improve or worsen properties. Surfacia addresses this by:

🔬 Chemical Foundation

All descriptors are based on quantum mechanical surface properties that directly relate to molecular interactions

🎯 Interpretability First

Every prediction comes with explanations that chemists can understand and act upon

⚡ Automation

Complete workflows require minimal user intervention while maintaining full control over parameters

🧠 AI Integration

Natural language explanations help translate mathematical results into chemical insights

Next Steps

1. Install Surfacia - Follow our Installation guide

2. Try the Quick Start - Run your first analysis with Quick Start

3. Learn the Concepts - Understand the theory behind Basic Concepts

4. Explore Commands - Check out the Command Reference reference

5. Connect MCP Clients - See Surfacia MCP Server for agent-facing usage

6. Read the Chinese Startup Guide - Use Surfacia MCP Server 从零启动手册 for first-time setup and debugging

7. Follow Tutorials - Work through Tutorials for real examples