Command Line Interface

The mol-platform --api-key your-key CLI provides command-line access to molecular generation and testing capabilities.

Overview

The CLI tool (mol-platform --api-key your-key) allows you to interact with the mol-platform --api-key your-key API without the web interface, making it ideal for:

• Automated testing
• Scripting and integration
• Development and debugging
• CI/CD pipelines

Installation

Build and install the CLI package:

cd backend
python3 -m venv venv && source venv/bin/activate && pip install build && python -m build
pipx install dist/mol_platform-1.0.0-py3-none-any.whl

This installs the mol-platform command globally. Provide the API key with --api-key (must match the backend's API_KEY).

Usage

Two Modes of Operation

1. Command Mode (Default)

Execute single commands directly:

mol-platform --api-key your-key [OPTIONS] COMMAND

2. Interactive Mode

Start an interactive session for multiple commands:

mol-platform --api-key your-key --interactive

Options

• --url URL: Backend API URL (default: http://localhost:8000)
• --interactive, -i: Start interactive mode
• --help: Show help message

Commands

Health Check

Test backend connectivity:

mol-platform --api-key your-key --health

Output:

Connecting to http://localhost:8000
--------------------------------------------------
✓ Health check passed: {'status': 'healthy', 'version': '1.0.0'}
--------------------------------------------------
✓ All tests passed

Molecule Generation

Generate molecules with mutations:

mol-platform --api-key your-key --generate "SMILES_STRING" [OPTIONS]

Options: - --mutations N: Number of mutations (default: 3) - --types TYPE [TYPE ...]: Mutation types (substituent, bond_order, atom_swap)

Examples:

# Basic generation
mol-platform --api-key your-key --generate "CCO"

# Custom mutations
mol-platform --api-key your-key --generate "CC(=O)OC1=CC=CC=C1C(=O)O" --mutations 2

# Specific mutation types
mol-platform --api-key your-key --generate "CCO" --types substituent

Sample Output:

Connecting to http://localhost:8000
--------------------------------------------------
Generating molecule from: CCO
✓ Molecule generation successful
  Original: CCO
  Generated: CC(C)O
  Properties: {
    "Molecular Weight": 46.07,
    "LogP": 0.16,
    "H-Bond Donors": 1,
    "H-Bond Acceptors": 1,
    "Topological Polar Surface Area": 20.2
  }
--------------------------------------------------
✓ All tests passed

Interactive Mode

Start interactive session:

mol-platform --api-key your-key --interactive

Interactive Commands:

mol-platform --api-key your-key> help
Available commands:
  health              - Test API health
  generate <smiles>   - Generate molecule from SMILES
  set mutations <n>   - Set number of mutations (default: 3)
  set types <types>   - Set mutation types (substituent bond_order atom_swap)
  status              - Show current settings
  clear               - Clear screen
  help                - Show this help
  quit                - Exit interactive mode

Examples:
  generate CCO
  set mutations 5
  set types substituent atom_swap
  health

Interactive Session Example:

🧬 mol-platform --api-key your-key Interactive CLI
Connected to: http://localhost:8000
Type 'help' for commands, 'quit' to exit
--------------------------------------------------
mol-platform --api-key your-key> set mutations 5
✓ Mutations set to 5
mol-platform --api-key your-key> generate CCO
Generating molecule from: CCO
✓ Molecule generation successful
  Original: CCO
  Generated: CC(C)(C)O
  Properties: {...}
mol-platform --api-key your-key> status
API URL: http://localhost:8000
Mutations: 5
Types: ['substituent', 'bond_order', 'atom_swap']
mol-platform --api-key your-key> quit
Goodbye! 👋

Options

• --url URL: Backend API URL (default: http://localhost:8000)
• --help: Show help message

Commands

Health Check

Test backend connectivity:

mol-platform --api-key your-key --health

Output:

Connecting to http://localhost:8000
--------------------------------------------------
✓ Health check passed: {'status': 'healthy', 'version': '1.0.0'}
--------------------------------------------------
✓ All tests passed

Molecule Generation

Generate molecules with mutations:

mol-platform --api-key your-key --generate "SMILES_STRING" [OPTIONS]

Options: - --mutations N: Number of mutations (default: 3) - --types TYPE [TYPE ...]: Mutation types (substituent, bond_order, atom_swap)

Examples:

# Basic generation
mol-platform --api-key your-key --generate "CCO"

# Custom mutations
mol-platform --api-key your-key --generate "CC(=O)OC1=CC=CC=C1C(=O)O" --mutations 2

# Specific mutation types
mol-platform --api-key your-key --generate "CCO" --types substituent atom_swap

Sample Output:

Connecting to http://localhost:8000
--------------------------------------------------
Generating molecule from: CCO
✓ Molecule generation successful
  Original: CCO
  Generated: CC(C)O
  Properties: {
    "Molecular Weight": 46.07,
    "LogP": 0.16,
    "H-Bond Donors": 1,
    "H-Bond Acceptors": 1,
    "Topological Polar Surface Area": 20.2
  }
--------------------------------------------------
✓ All tests passed

Prerequisites

• Python 3.12+
• Running mol-platform --api-key your-key backend server
• requests library (included in backend environment)

Error Handling

The CLI provides clear error messages:

• Connection Errors: When backend is not accessible
• Validation Errors: For invalid SMILES or parameters
• API Errors: Server-side processing failures

Integration

CI/CD Usage

- name: Test CLI
  run: |
    mol-platform --api-key your-key --health
    mol-platform --api-key your-key --generate "CCO"

Scripting

import subprocess

# Health check
result = subprocess.run(["mol-platform --api-key your-key", "--health"], capture_output=True)
print("Exit code:", result.returncode)

# Generation
result = subprocess.run([
    "mol-platform --api-key your-key", "--generate", "CCO", "--mutations", "1"
], capture_output=True)
print("Output:", result.stdout.decode())

Troubleshooting

Common Issues

1. Connection Refused
2. Ensure backend server is running on localhost:8000

3. Check firewall settings

4. Invalid SMILES

5. Verify SMILES string is valid

6. Use tools like ChemDraw for validation

7. Permission Errors

8. Ensure the package is installed correctly with pipx

Debug Mode

For detailed error information, check the backend server logs while running CLI commands.