Appearance

Getting Started ​

This guide walks you through creating an account, generating an API key, installing the SDK, and initializing the client.

Create an Account ​

  1. Go to app.smplkit.com
  2. Sign up with Google, Microsoft, or email/password
  3. You'll land in the developer console with a default environment

Create an API Key ​

  1. In the console sidebar, click API Keys
  2. Click + Create API Key
  3. Give it a name (e.g., "Development")
  4. Click Create
  5. Copy the key — it starts with sk_api_

Your API key authenticates all SDK and API calls. Store it securely — treat it like a password.

Configure Your Environment ​

The SDK resolves your API key automatically. You have two options:

Config file ​

Create ~/.smplkit with your API key:

ini
[default]
api_key = sk_api_your_key_here

Environment variable ​

bash
export SMPLKIT_API_KEY=sk_api_your_key_here

The environment variable takes precedence over the config file.

For advanced configuration — profiles, precedence rules, and the full reference — see the Configuration guide.

Install the SDK ​

bash
pip install smplkit-sdk

Requires Python 3.10+.

Initialize the Client ​

python
from smplkit import AsyncSmplClient

async with AsyncSmplClient(environment="production", service="my-service") as client:
    pass

A synchronous client is also available:

python
from smplkit import SmplClient

with SmplClient(environment="production", service="my-service") as client:
    pass

The client resolves the API key automatically from the environment variable or config file. To pass it explicitly, use the apiKey (or api_key in Python) parameter in the constructor options.

What's Next ​

  • Configuration — Profiles, environment variables, and precedence rules
  • Smpl Config — Manage application configuration across environments
  • Smpl Flags — Control feature rollouts with rules-based targeting
  • Smpl Logging — Control log verbosity without redeploying