stspeck

The Speck molecule viewer for Streamlit, with the same renderer and settings as the ipyspeck Jupyter widget: ambient occlusion, cartoons, molecular surfaces (optionally transparent), metallic and glossy materials, shadows, fog, outlines, highlighting, trajectories and unit cells.

pip install stspeck      # Python 3.8+, Streamlit 1.20+

import streamlit as st
import stspeck

# Any structure as PDB or (extended) XYZ text
stspeck.speck(data=open("1ubq.pdb").read(), cartoon=True, surface=True, surfaceOpacity=0.35)

# Loaders return keyword arguments to splat into speck()
stspeck.speck(**stspeck.fetch_alphafold("Q8W3K0"), preset="cover", height=500)
stspeck.speck(**stspeck.fetch_pdb("4HHB"), highlight={"resName": "HEM"}, ghost=0.6)
stspeck.speck(**stspeck.from_ase(atoms), preset="metal")   # also from_rdkit, from_pymatgen

• Settings: every ipyspeck setting is a keyword argument; see stspeck.SETTINGS for names and defaults, and stspeck.PRESETS for named looks (preset="cover").
• Toolbar: styles, a looks menu, cartoon / surface / ligand toggles, standard views, auto-rotate, tap to focus (or Alt-click), a depth-of-field toggle, a color menu for cartoon, surface and atoms, and a camera button that downloads a high-resolution PNG (export_width=3000, export_scale=...). Toolbar choices persist across reruns.
• Colors: colorScheme="jmol" (speck, jmol, rasmol, newcpk) and per-element atomColors={"Au": "#ffcc33"} ('#rrggbb' or [r, g, b] in 0 - 1).
• Touch and keyboard: one finger rotates, two fingers pinch to zoom and pan; arrows rotate, Shift+arrows pan, + / - zoom, 0 recenters, F focuses at the center.
• State: with return_state=True the call returns the camera, the current settings and nframes; pass the camera back as camera= to restore a view.
• Trajectories: multi-frame XYZ or multi-model PDB; drive frame= with a slider (stspeck.count_frames(data) gives the range).

Run the demo with streamlit run example/app.py.

Gallery

Rendered with the ipyspeck / stspeck renderer (see example/showcase.ipynb for the settings behind these looks). Click an image to open that scene in the live demo.

Macro photography (depth of field)

Gold nanoparticle, 923 atoms	Copper surface	Heme in hemoglobin (4HHB)
Imatinib in ABL kinase (1IEP)	Nucleosome DNA (1KX5)	AlphaFold RPP7 repeat domain

Proteins and complexes

AlphaFold RPP7, by pLDDT	Hemoglobin, glass surface (4HHB)	SARS-CoV-2 spike (6VXX)
IgG antibody (1IGT)	Green fluorescent protein (1EMA)	GroEL–GroES chaperonin (1AON)
KcsA K⁺ channel (1BL8)	CRISPR-Cas9 with guide RNA (4OO8)	HIV protease + saquinavir (1HXB)
Streptavidin–biotin (1STP)	Myoglobin, toon style (1MBN)	Collagen triple helix (1BKV)
Ubiquitin surface (1UBQ)

Nucleic acids

Nucleosome (1KX5)

Transfer RNA (1EHZ)

G-quadruplex with K⁺ (1KF1)

Chemistry and materials

Gold–thiolate cluster	Copper crystal and unit cell	SrTiO₃ perovskite
MoS₂ monolayer	Graphene	Carbon nanotube
C₆₀ buckminsterfullerene	Taxol (paclitaxel)	Chlorophyll a
Caffeine

For Jupyter, use ipyspeck, which has the same settings.

Development

The frontend (frontend/) bundles the viewer shared with ipyspeck (../core). Build it with cd frontend && npm install && npm run build, which also compiles ../core. pip install . runs the same build when stspeck/static is missing.

License

BSD-3-Clause (see LICENSE). stspeck is based on Speck by wwwtyro, which is in the public domain (see LICENSE-SPECK).