How stanfordnlp/dspy works
DSPy is a Python framework for composing language-model programs and optimizing their instructions, demonstrations, or weights. A typical workflow defines typed signatures, runs predictors through adapters and an LM client, optionally retrieves evidence, evaluates outputs, and uses teleprompt optimizers to improve a program. The graph also preserves streaming, interpreter-backed reasoning, datasets, and the bundled lm15 provider/authentication runtime. Relationships are limited to README statements and references visible in the supplied source index or excerpts; unsampled subsystems are shown without speculative call edges.
Main entry points: router.py Provider router · teleprompt Teleprompt optimizers · predict Predictors · base.py Adapters
Components 20
Program Construction
- Signatures
dspy/signatures/signature.py - Predictors
dspy/predict - Predictions
dspy/primitives/prediction.py
Model Runtime
- Adapters
dspy/adapters/base.py - LM requests
dspy/clients/requests.py - LM client
dspy/clients/lm.py - LM engines
dspy/clients/engines - lm15 API
dspy/lm15.py - Provider router
dspy/_vendor/lm15/router.py - Provider registry
dspy/_vendor/lm15/registry.py - Provider adapters
dspy/_vendor/lm15/providers - Managed login
dspy/_vendor/lm15/login/manager.py - Streaming
dspy/streaming/streaming_listener.py
Optimization and Evaluation
- Evaluation
dspy/evaluate/evaluate.py - Teleprompt optimizers
dspy/teleprompt - Grounded proposer
dspy/propose/grounded_proposer.py
Data and Extensions
- Retrieval
dspy/retrievers/retrieve.py - Datasets
dspy/datasets/dataset.py - Code interpreter
dspy/primitives/code_interpreter.py
Other components
- DSPy user
Connections 19
- DSPy user → Signatures: defines program
- Signatures → Adapters: formats fields
dspy/adapters/base.py - Adapters → LM requests: builds request
dspy/adapters/base.py - LM requests → lm15 API: uses interface
dspy/clients/requests.py - lm15 API → Provider router: exposes routing
dspy/lm15.py - Provider router → Provider registry: resolves providers
dspy/_vendor/lm15/router.py - Provider registry → Provider adapters: registers adapters
dspy/_vendor/lm15/registry.py - LM engines → Provider router: routes native calls
dspy/clients/engines/lm15_engine.py - LM engines → lm15 API: uses interface
dspy/clients/engines/base.py - Managed login → Provider router: consults provider config
dspy/_vendor/lm15/login/manager.py - Predictors → Predictions: produces outputs
dspy/predict/rlm.py - Retrieval → Predictions: returns results
dspy/retrievers/retrieve.py - Evaluation → Predictions: evaluates outputs
dspy/evaluate/evaluate.py - Teleprompt optimizers → Evaluation: scores programs
dspy/teleprompt/random_search.py - Teleprompt optimizers → Predictors: optimizes programs
- Grounded proposer → Datasets: summarizes data
dspy/propose/grounded_proposer.py - Grounded proposer → Teleprompt optimizers: uses optimizer utilities
dspy/propose/grounded_proposer.py - Streaming → Adapters: assembles streams
dspy/streaming/streaming_listener.py - Code interpreter → Predictors: supports reasoning
dspy/predict/rlm.py