Happenstance CLI
Command-line interface for Happenstance — search your network with AI. Find warm intros for sales, source referral candidates for hiring, discover investors for fundraising, and research anyone in your network.
Install
# Homebrew (macOS / Linux)
brew tap happenstance-ai/tap
brew install happenstance
# uv
uv tool install happenstance
# pipx
pipx install happenstance
# pip
pip install happenstance
Quick start
# Configure your API key (get one at https://happenstance.ai/integrations/keys)
hpn config set --api-key YOUR_API_KEY
# Search your network
hpn search "CISOs interested in AI in the SF Bay Area"
# Research a specific person
hpn research "https://www.linkedin.com/in/garrytan/"
# Check your credit balance
hpn usage
Commands
| Command | Description |
|---|---|
hpn config set --api-key KEY |
Save your API key |
hpn config show |
Show saved API key (masked) |
hpn search "query" |
Search your network |
hpn search get ID |
Get search results |
hpn search find-more ID |
Find additional results |
hpn research "description" |
Research a person |
hpn research get ID |
Get research results |
hpn friends |
List your friends |
hpn groups |
List your groups |
hpn groups get ID |
Get group details |
hpn usage |
Show credit balance |
Configuration
The API key can be provided in three ways (in priority order):
--api-keyflag on any commandHPN_API_KEYenvironment variable- Config file at
~/.hpn/config.json(set viahpn config set)
All output is JSON and can be piped to jq for processing.
Documentation
Full API docs: https://developer.happenstance.ai
Development
See DEVELOPMENT.md for local setup, tests, and releases.
2 maintainers
Release files for happenstance 0.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| happenstance-0.2.4.tar.gz | 52.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| happenstance-0.2.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 63.5 kB
Release files / happenstance-0.2.4.tar.gz
| Download URL | happenstance-0.2.4.tar.gz |
|---|---|
| Size | 52.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9d44a621c3e9a11c3d3ff697f9bbad033e037e158562f11c3b47ea5d60325fe3
|
|
BLAKE2b-256 checksum How to use checksums |
1e06e6c3a806e68e04ba80066aba2d224bdd198570a97d9667f4f1c718222a19
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / happenstance-0.2.4-py3-none-any.whl
| Download URL | happenstance-0.2.4-py3-none-any.whl |
|---|---|
| Size | 10.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
760e0977a793b45b4272a8d050a383aeb6f61d74ae28e1aadb75b737f9bf61c9
|
|
BLAKE2b-256 checksum How to use checksums |
d2ec43354f1e3cf57cffe852adbfe533aebe99187261aa46cb9015729c54ef34
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency log
