Metadata-Version: 2.4
Name: instant-messaging
Version: 0.1.0
Summary: Developer-first messaging infrastructure toolkit for SMS, WhatsApp, Telegram, and future channels.
Author: Instant contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/isonlycoolie/instant
Project-URL: Repository, https://github.com/isonlycoolie/instant
Project-URL: Issues, https://github.com/isonlycoolie/instant/issues
Keywords: messaging,sms,whatsapp,telegram,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML>=6
Dynamic: license-file

# Instant

Instant is a developer-first messaging infrastructure toolkit for connecting backend applications to SMS, WhatsApp, Telegram, and future communication channels through one simple SDK and CLI.

The product rule is:

> Simple by default. Deep when needed.

Instant is built around a Rust core engine, a Python SDK first, provider adapters, a CLI, local sandbox providers, and optional production runtime profiles for teams that need queues, workers, observability, and scale.

## What Instant Does

- Sends and receives messages across supported channels.
- Normalizes provider-specific APIs into one developer-facing contract.
- Lets developers configure providers through one file and environment variables.
- Supports local sandbox testing before real provider credentials are used.
- Starts with East Africa-focused providers and expands cleanly.

## Open Source

Instant is released under the [MIT License](LICENSE).

Contributions are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) for branch rules, commit style, test expectations, and open-source scope.

## Repository Layout

```text
crates/          Rust core engine, providers, runtime, observability
sdk/             Language SDKs, starting with Python
cli/             Instant command-line interface
apps/            Optional application surfaces
examples/        Framework examples and integration samples
infra/           Local and production infrastructure templates
packages/        Shared schemas and cross-language assets
tests/           Contract, integration, sandbox, and end-to-end tests
tools/           Developer tooling and repository automation
```
