# stanfordnlp/dspy · RepoSense Release & Migration Intelligence

> `skills`: reference material for the reflection LM. Pass a. Review breaking API changes before up… Migration: Moderate.

## Metadata
- **Repository URL**: https://github.com/stanfordnlp/dspy
- **Primary Package**: `dspy-ai` (NPM)
- **Categories**: `AI-FRAMEWORK`, `AI-EVALS`, `BACKEND`
- **Latest Version**: `v3.4.1`
- **Semantic Status**: `BREAKING`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/stanfordnlp/dspy/releases.atom

## The Human Context (Plain-English Pitch)
dspy-ai is an open-source library and developer tool in the stanfordnlp/dspy ecosystem. It saves developers from writing repetitive low-level boilerplate from scratch by providing a battle-tested, open-source implementation ready for production.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
`skills`: reference material for the reflection LM. Pass a. Review breaking API changes before up… Migration: Moderate.

## Breaking Changes & Required Actions
- [BREAKING] To keep a removed model working offline, point `LITELLM_MODEL_COST_MAP_URL` at a metadata file that still contains its entry, and unset `LITELLM_LOCAL_MODEL_COST_MAP`. The file replaces the whole map, so it must cover every model you use.
- [BREAKING] DSPy now supports Python 3.15 (`requires-python = ">=3.10, <3.16"`).
- `skills`: reference material for the reflection LM. Pass a path, a directory containing `SKILL.md`, an inline string, or a list of these. YAML frontmatter is parsed at construct...
- `additional_instructions`: extra guidance applied to every proposal.
- `base_instructions`: replaces the reflection prompt but keeps its input and output fields.
- `max_chars`: a hard character limit. A draft that is too long gets one compression attempt; DSPy never truncates an instruction.

## Migration Snippet
```ts
npm install dspy-ai@3.4.1
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **TypeScript 5.x** [`COMPATIBLE`]: Ships standard TypeScript declaration files without type regressions.

## Zero-Noise Release Timeline
- **v3.4.1** (2026-10-12) [BREAKING]: `skills`: reference material for the reflection LM. Pass a. Review breaking API changes before up… Migration: Moderate.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is stanfordnlp/dspy v3.4.1 safe to upgrade in production?
stanfordnlp/dspy v3.4.1 is classified as BREAKING (PATCH release). `skills`: reference material for the reflection LM. Pass a. Review breaking API changes before up… Migration: Moderate.

### What breaking changes or compatibility risks exist in stanfordnlp/dspy v3.4.1?
To keep a removed model working offline, point `LITELLM_MODEL_COST_MAP_URL` at a metadata file that still contains its entry, and unset `LITELLM_LOCAL_MODEL_COST_MAP`. The file replaces the whole map, so it must cover every model you use. DSPy now supports Python 3.15 (`requires-python = ">=3.10, <3.16"`).

### What is the bundle size impact of dspy-ai v3.4.1?
Measured bundle size telemetry is currently unavailable for dspy-ai v3.4.1; verify build output locally before deploying.

### How do I upgrade dspy-ai to v3.4.1?
Upgrade dspy-ai to v3.4.1 by running "npm install dspy-ai@3.4.1" and applying the migration steps: npm install dspy-ai@3.4.1