Metadata-Version: 2.5
Name: stoa-cli
Version: 1.0.2
Summary: Stoa Markets from the terminal: sign in, browse the catalog, open requests for quote and read the quotes that come back.
Project-URL: Homepage, https://www.stoaexchange.com
Project-URL: Documentation, https://www.stoaexchange.com/docs/cli
Project-URL: Changelog, https://www.stoaexchange.com/docs/cli/changelog
Author: Stoa Markets, Inc.
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: cli,gpu,marketplace,rfq,stoa
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Office/Business :: Financial
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: click>=8.3.3
Requires-Dist: httpx>=0.27
Requires-Dist: keyring>=25.7
Description-Content-Type: text/markdown

# stoa

Stoa Markets from the terminal: sign in, browse the GPU catalog, open requests for quote (RFQs)
and read the quotes dealers send back. Accepting a quote is a binding trade and happens in the
web application, at the link the client prints.

Documentation: https://www.stoaexchange.com/docs/cli
Changelog: https://www.stoaexchange.com/docs/cli/changelog

## Install

Python 3.12 or newer and an operating system keychain to hold the session: the macOS Keychain,
the Windows Credential Manager, or a Secret Service keyring on Linux (GNOME Keyring, KDE
Wallet). On a headless Linux box, in WSL, or over SSH, start and unlock one in your session
first (on macOS over SSH: `security unlock-keychain`); the client never stores a session in a
file.

```sh
uv tool install stoa-cli
# or
pipx install stoa-cli
```

Upgrade with `uv tool install stoa-cli@latest` or `pipx install --force stoa-cli`.

## Access

Every command needs a signed-in session. Sign in with your Stoa Markets email, password and
second factor; the account needs an active Stoa Markets registration.

## Security

See SECURITY.md. Report vulnerabilities to security@stoaexchange.com.

## License

Apache-2.0. "Stoa" and the Stoa Markets marks belong to Stoa Markets, Inc.; the license grants no
trademark rights.
