Method configure

dspy/dsp/utils/settings.py:165–213

Set the default language model, adapter, and other settings for DSPy. Call `dspy.configure(...)` once near the top of your script. Every DSPy module will use these defaults unless you override them with `dspy.context(...)`. The values persist until you call `dspy.con

(self, **kwargs)

            )

    def configure(self, **kwargs):
        """Set the default language model, adapter, and other settings for DSPy.

        Call `dspy.configure(...)` once near the top of your script. Every
        DSPy module will use these defaults unless you override them with
        `dspy.context(...)`. The values persist until you call
        `dspy.configure(...)` again.

        Only the thread that first calls `dspy.configure(...)` may call it
        again. Use `dspy.context(...)` for temporary overrides in other
        threads or async tasks.

        Args:
            **kwargs: Settings to update. Common keys include `lm` (a
                `dspy.LM`), `adapter` (e.g. `dspy.JSONAdapter()`),
                `callbacks`, `track_usage`, `async_max_workers`, and
                `num_threads`.

        Examples:
            Set a default LM:
            ```python
            import dspy

            dspy.configure(lm=dspy.LM("openai/gpt-5-mini"))
            ```

            Set multiple defaults at once:
            ```python
            import dspy

            dspy.configure(
                lm=dspy.LM("anthropic/claude-sonnet-4-6"),
                adapter=dspy.JSONAdapter(),
                track_usage=True,
            )
            ```

        See Also:
            [`dspy.LM`][dspy.LM]: create the language model you pass as `lm`.
            `dspy.context`: temporary overrides inside one block.
        """
        # `dspy.configure` is documented manually in docs/docs/api/utils/context.md
        # changes here should be reflected there as well.
        # If no exception is raised, the `configure` call is allowed.
        self._ensure_configure_allowed()

        # Update global config
        for k, v in kwargs.items():
            main_thread_config[k] = v

    @contextmanager
    def context(self, **kwargs):