Smith (Agent Smith)

Smith Fleet Management

Smith is an open-source fleet management system built in Rust for managing distributed IoT devices at scale. Born from managing thousands of devices across healthcare facilities, Smith provides the automation and reliability you need to deploy, monitor, and update your fleet with confidence.

Why Smith?

Built for Scale: Manage everything from hundreds to thousands of devices
Reliable: Designed for >99% uptime in critical environments
Seamless Updates: Deploy upgrades and rollbacks with zero manual intervention
Transparent: Open-source infrastructure you can trust and extend

Architecture

Smith consists of five main components:

smithd: Daemon that runs on each device to execute deployments and report status
updater: Daemon that keeps smithd up to date
api: Backend service managing deployment configurations and fleet status
dashboard: Visual interface to monitor your fleet in real-time
cli (sm): Command-line tool for fleet administrators

Getting Started

Visit our documentation to get started with Smith.

Local Development

Prerequisites: Docker

make init       # creates .env and dashboard/.env from templates
make up         # starts all services (api, dashboard, postgres, bore, device)
make migrate    # runs database migrations
make seed       # seeds the database with test data

API: http://localhost:8080
Dashboard: http://localhost:3000

Device options

Set in .env or inline with docker compose up:

Variable	Default	Description
`DEVICE_BASE_IMAGE`	`nvcr.io/nvidia/l4t-base:r36.2.0`	Base image. Use `ubuntu:22.04` on x86_64.
`DEVICE_REPLICAS`	`1`	Number of simulated devices
`NETWORK_THROTTLE`	`random`	`none`, `random`, or a fixed Mbps value
`GLOBAL_BANDWIDTH_LIMIT`	`100`	API egress cap in Mbps

DEVICE_BASE_IMAGE=ubuntu:22.04 DEVICE_REPLICAS=3 NETWORK_THROTTLE=none docker compose up

Contributing

We welcome contributions! Whether you're fixing bugs, adding features, or improving documentation, your help makes Smith better for everyone. Check out our issues or submit a PR.

Security

Security is a top priority for Smith. If you discover a security vulnerability, please email security@teton.ai. We operate a bug bounty program and have paid bounties for responsibly disclosed vulnerabilities. See our Security Policy for more details.

License

The Smith source and documentation are released under the Apache License 2.0

Smith Documentation