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 
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
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)
        )

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

    def close(self) -> None:
        self.backend.close()

    def __enter__(self) -> Self:
        return self

    def __exit__(self, *exc: object) -> None:
        self.close()

backend instance-attribute 

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

ask 

ask(
    state: State,
    questions: QuestionInput,
    *,
    model: str | None = None,
) -> SystemOneOutput
Source code in system_one/agent.py 
64
65
66
67
def ask(
    self, state: State, questions: QuestionInput, *, model: str | None = None
) -> SystemOneOutput:
    return self.backend.ask(self._input(state, questions, model))

close 

close() -> None
Source code in system_one/agent.py 
69
70
def close(self) -> None:
    self.backend.close()

AsyncSystemOne

Bases: BaseSystemOne

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

Source code in system_one/agent.py 
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
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)
        )

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

    async def close(self) -> None:
        await self.backend.close()

    async def __aenter__(self) -> Self:
        return self

    async def __aexit__(self, *exc: object) -> None:
        await self.close()

backend instance-attribute 

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

ask async 

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

close async 

close() -> None
Source code in system_one/agent.py 
 99
100
async def close(self) -> None:
    await self.backend.close()

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=...) or ONNXConfig() — 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 
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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=...)` or `ONNXConfig()` —
    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:
        if config is not None and "backend" not in overrides:
            overrides["backend"] = "onnx" if isinstance(config, ONNXConfig) else "http"
        self.settings = Settings(**overrides)
        self.config = config

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

backend instance-attribute 

backend: Any

settings instance-attribute 

settings = Settings(**overrides)

config instance-attribute 

config = config