smarter-python

Getting Started

  • Installation
    • Prereleases
  • Quickstart
    • Prompt an LLMClient
    • Apply a manifest
    • Chat, and stream a prompt’s progress
    • Handle errors

User Guide

  • Configuration
    • API keys
    • Environment variables
    • Sharing the CLI’s configuration
    • Your own HTTP client
  • Manifests
    • The manifest API
    • Each resource’s own methods
    • Typed manifests
    • Manifests in CI/CD
  • Prompts and Chat
    • One prompt
    • A conversation
    • A chat’s configuration
    • Streaming a prompt’s progress
    • Failed prompts
  • Resources
    • Guardrails
    • MCP clients
    • Vectorstores
    • LLMHosts
    • Proxies
    • Endpoints the SDK does not wrap
  • Models
    • SAM models
    • API contracts
    • REST models
  • Errors and Reliability
    • Exceptions
    • Retries and timeouts
    • Logging

Reference

  • API Reference
    • The Client
      • smarter.client
    • Resources
      • smarter.resources.base
      • smarter.resources.manifests
      • smarter.resources.llmclients
      • smarter.resources.guardrails
      • smarter.resources.mcpclients
      • smarter.resources.vectorstores
      • smarter.resources.llmhosts
      • smarter.resources.catalog
      • smarter.resources.accounts
      • smarter.resources.history
      • smarter.resources.providers
      • smarter.resources.proxies
    • Models
      • smarter.models.base
      • smarter.models.manifest
      • smarter.models.platform
      • smarter.models.account
      • smarter.models.llmclient
      • smarter.models.plugin
      • smarter.models.guardrail
      • smarter.models.mcpclient
      • smarter.models.vectorstore
      • smarter.models.llmhost
      • smarter.models.misc
    • API Contracts
      • smarter.models.chat
      • smarter.models.journal
      • smarter.models.react
    • SAM Models
      • SAMModel
      • SAM_MODELS
      • SAMAccount
      • SAMApiConnection
      • SAMApiPlugin
      • SAMBudget
      • SAMCustomDomain
      • SAMGuardrail
      • SAMImageSearchPlugin
      • SAMLLMClient
      • SAMLLMHost
      • SAMLLMHostCompute
      • SAMMCPClient
      • SAMOrchestrator
      • SAMPlugin
      • SAMPrompt
      • SAMProvider
      • SAMProxy
      • SAMSecret
      • SAMSkillPlugin
      • SAMSmarterAuthToken
      • SAMSqlConnection
      • SAMSqlPlugin
      • SAMUser
      • SAMVectorsearch
      • SAMVectorstore
      • SAMWebsearchPlugin
      • sam_model()
      • smarter.models.sam.base
      • Every kind
    • Configuration, Transport and Errors
      • smarter.core.conf
      • smarter.core.exceptions
      • smarter.core.http
      • smarter.core.streaming
      • smarter.core.log
      • smarter.core.typing

Project

  • Changelog
  • Contributing
    • Development setup
    • Tests
    • Keeping in step with the platform
    • Documentation
    • Pull requests
    • Code of conduct
  • License
  • Architectural Decision Records
    • ADR Introduction
      • Guidelines for writing ADRs
    • ADR-001: Scope and Purpose of the SDK
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-002: Configuration
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-003: Writes Go Through the Manifest API
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-004: Pydantic Models, Forward Compatible
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-005: Mirrored Contracts and Generated SAM Models
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-006: Error Handling
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-007: Logging
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-008: HTTP Transport, Retries and Timeouts
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-009: Testing
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-010: CI/CD
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-011: Dependency Management
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-012: Docstrings and Documentation
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-013: Type Annotations
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-014: Code Quality
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-015: Semantic Versioning and API Versions
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-016: Security
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-017: No Response Caching
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-018: A Synchronous Client First
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-019: Supported Python Versions
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-022: A Pinned Copy of the Platform’s OpenAPI Document
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-023: A Documentation Site of Its Own
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-024: CI and the Release Workflow
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
    • ADR-025: Packaging and Compiled Requirements
      • Status
      • Context
      • Decision
      • Alternatives Considered
      • Consequences
      • Related ADRs
smarter-python
  • Search

© Copyright 2026, Lawrence McDaniel.

Built with Sphinx using a theme provided by Read the Docs.

smarter-python is the Python SDK of The Smarter Project, an open-source platform for building and running AI applications with Django.