Skip to content

Agent

SystemOne

Bases: BaseSystemOne

Ask typed questions about a state and get calibrated answers back.

Source code in system_one/agent.py 
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
class SystemOne(BaseSystemOne):
    """Ask typed questions about a state and get calibrated answers back."""

    def __init__(
        self,
        config: BackendConfig | None = None,
        *,
        using: Backend | None = None,
        **overrides: Any,
    ) -> None:
        super().__init__(config, **overrides)
        self.backend: Backend = (
            using
            if using is not None
            else create_backend(self.settings, config, **self.overrides)
        )

    def ask(
        self, state: State, questions: QuestionInput, *, model: str | None = None
    ) -> SystemOneOutput:
        return self.backend.ask(self._input(state, questions, model))

backend instance-attribute 

backend: Backend = (
    using
    if using is not None
    else create_backend(
        self.settings, config, **self.overrides
    )
)

ask 

ask(
    state: State,
    questions: QuestionInput,
    *,
    model: str | None = None,
) -> SystemOneOutput
Source code in system_one/agent.py 
75
76
77
78
def ask(
    self, state: State, questions: QuestionInput, *, model: str | None = None
) -> SystemOneOutput:
    return self.backend.ask(self._input(state, questions, model))

AsyncSystemOne

Bases: BaseSystemOne

The async counterpart of SystemOne: the same ask, awaited.

Source code in system_one/agent.py 
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
class AsyncSystemOne(BaseSystemOne):
    """The async counterpart of `SystemOne`: the same `ask`, awaited."""

    def __init__(
        self,
        config: BackendConfig | None = None,
        *,
        using: AsyncBackend | None = None,
        **overrides: Any,
    ) -> None:
        super().__init__(config, **overrides)

        self.backend: AsyncBackend = (
            using
            if using is not None
            else create_async_backend(self.settings, config, **self.overrides)
        )

    async def ask(
        self, state: State, questions: QuestionInput, *, model: str | None = None
    ) -> SystemOneOutput:
        return await self.backend.ask(self._input(state, questions, model))

backend instance-attribute 

backend: AsyncBackend = (
    using
    if using is not None
    else create_async_backend(
        self.settings, config, **self.overrides
    )
)

ask async 

ask(
    state: State,
    questions: QuestionInput,
    *,
    model: str | None = None,
) -> SystemOneOutput
Source code in system_one/agent.py 
 99
100
101
102
async def ask(
    self, state: State, questions: QuestionInput, *, model: str | None = None
) -> SystemOneOutput:
    return await self.backend.ask(self._input(state, questions, model))

BaseSystemOne

Settings resolution and input building, shared by the sync and async agents.

config is the backend's own configuration — TypesafeConfig(), OpenRouterConfig(), HTTPConfig(base_url=..., model=...), ONNXConfig() or StubConfig() — and picks the backend to build; omitted, SYSTEM_ONE_BACKEND decides and the config is read from the environment. using hands over an already-built backend instead, which is how tests and custom providers plug in.

Source code in system_one/agent.py 
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
class BaseSystemOne:
    """Settings resolution and input building, shared by the sync and async agents.

    `config` is the backend's own configuration — `TypesafeConfig()`,
    `OpenRouterConfig()`, `HTTPConfig(base_url=..., model=...)`, `ONNXConfig()` or
    `StubConfig()` —
    and picks the backend to build; omitted, `SYSTEM_ONE_BACKEND` decides and the
    config is read from the environment. `using` hands over an already-built backend
    instead, which is how tests and custom providers plug in.
    """

    backend: Any  # narrowed to `Backend` / `AsyncBackend` by the two subclasses

    def __init__(self, config: BackendConfig | None = None, **overrides: Any) -> None:
        backend = overrides.pop("backend", None)
        if backend is None and config is not None:
            backend = _backend_name(config)
        self.settings = Settings() if backend is None else Settings(backend=backend)
        self.config = config
        self.overrides = overrides

    def _input(
        self, state: State, questions: QuestionInput, model: str | None
    ) -> SystemOneInput:
        return SystemOneInput.model_validate(
            {
                "state": state,
                "model": model or self.backend.model,
                "questions": questions,
            }
        )

backend instance-attribute 

backend: Any

settings instance-attribute 

settings = (
    Settings()
    if backend is None
    else Settings(backend=backend)
)

config instance-attribute 

config = config

overrides instance-attribute 

overrides = overrides