alion 0.1.0__tar.gz

alion-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+node_modules/
+dist/
+*.tgz
+.env
+__pycache__/
+*.egg-info/
+.venv/
+build/

alion-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alion
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

alion-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.5
+Name: alion
+Version: 0.1.0
+Summary: Official Alion client: companies, startups, investors, job postings, hiring and pay statistics and people open to offers, as typed calls for code and AI agents. Free without a key for compact searches.
+Project-URL: Homepage, https://alion.io/developers
+Project-URL: Documentation, https://alion.io/developers
+Project-URL: Source, https://github.com/alion-io/alion-sdk
+Project-URL: Issues, https://github.com/alion-io/alion-sdk/issues
+Author-email: Alion <info@alion.io>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai agents,alion,company data,company enrichment,funding rounds,investors,job postings,jobs api,labor market,llm tools,lookalike companies,mcp,model context protocol,salary data,sales prospecting,startups,tech stack,venture capital
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: typing-extensions>=4.7; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# alion
+
+The official Python client for [Alion](https://alion.io/developers): a live graph of companies worldwide (what each one does, where it operates, its tech stack, funding rounds and investors, how fast it hires), startup investors, verified job postings with hiring and pay statistics, and people open to offers.
+
+Every tool of the [Alion MCP server](https://alion.io/developers/agents) is a typed method, sync or async. Python 3.9+. It uses only the standard library (plus `typing_extensions` before 3.11).
+
+```bash
+pip install alion
+```
+
+## Free without a key
+
+```python
+from alion import Alion
+
+alion = Alion()  # no key: the open address, free within a daily allowance
+
+companies = alion.search_companies(industry="Fintech", country="DE", startup=True, funding_stage="early", limit=10)
+for c in companies["items"]:
+    print(c["name"], c["domain"])
+
+match = alion.resolve_company(domain="stripe.com")["match"]
+jobs = alion.search_jobs(query="data engineer", country="PL", work_mode="remote")
+```
+
+Without a key you get compact company, investor and job searches, lookalike companies, full job postings, the people tools and the agent tools. The allowance is 300 calls a day per network, 30 a minute, and up to 20 rows per list.
+
+## Everything with a key
+
+Create a key at [alion.io/developers/keys](https://alion.io/developers/keys) and pass it, or set `ALION_API_KEY`:
+
+```python
+alion = Alion(api_key="...")
+
+stripe = alion.get_company(domain="stripe.com")          # funding, hiring, stack, offices, visa
+pay = alion.market_stats(role="Backend Developer", country="US")
+fund = alion.get_investor(domain="sequoiacap.com")
+```
+
+Calls with a key are paid from your account's credits. Prices are at [alion.io/developers](https://alion.io/developers).
+
+## Async
+
+```python
+from alion import AsyncAlion
+
+async with AsyncAlion() as alion:
+    jobs = await alion.search_jobs(query="rust", country="DE")
+```
+
+## Paging
+
+```python
+for company in alion.paginate("search_companies", technology="Snowflake", hiring=True, max_items=50):
+    print(company["name"])
+```
+
+The server stops a search at row 100. Narrow the filters to reach further.
+
+## Errors
+
+Every failure is an `AlionError` with a machine-readable `code`:
+
+```python
+from alion import AlionError
+
+try:
+    alion.get_company(domain="stripe.com")
+except AlionError as e:
+    e.code           # "account_required", "invalid_params", "rate_limited", "unauthorized", "timeout", ...
+    e.needs_account  # True when the tool needs a key or a payment
+    e.data           # the server's full answer: hints, free_tools, examples
+```
+
+Rate limits (429), network errors and server errors on read-only tools are retried twice with backoff by default.
+
+## Options
+
+```python
+Alion(
+    api_key="...",            # default: ALION_API_KEY; "" forces the open address
+    app_name="my-agent/1.0",  # added to the User-Agent so Alion can tell your agent apart
+    timeout=60.0,
+    max_retries=2,
+    headers={...},            # extra headers on every call
+    transport=my_transport,   # (url, headers, body, timeout) -> (status, headers, text), e.g. over httpx or requests
+)
+```
+
+Any tool can also be called by name, including tools added to the server after this release:
+
+```python
+alion.call("check_counterparty", {"target": "acme.com"})
+alion.list_tools()  # names, descriptions, input and output schemas
+```
+
+## Tools
+
+| Method | What it does |
+|---|---|
+| `search_companies` | Companies by industry, country, size, founding year, startup, funding stage, investor, technology, ATS, hiring and growth level |
+| `similar_companies` | Lookalikes of a company |
+| `get_company` | One company in depth: funding, hiring, stack, offices, visa sponsorship |
+| `resolve_company` | Which company a name or a domain means |
+| `search_investors`, `get_investor` | Funds, accelerators and angels: what they back, at which stage, how active now |
+| `search_jobs`, `get_job` | Verified job postings |
+| `market_stats` | Demand, pay percentiles, top employers and technologies of a role in a country |
+| `search_people`, `match_people`, `similar_people`, `get_person`, `check_fit` | People open to offers |
+| `send_message`, `get_conversation`, `list_conversations` | Write to people in Alion messages |
+| `watch_search`, `check_watch`, `list_watches`, `delete_watch`, `set_webhook` | Follow a search for new results |
+| `check_counterparty`, `check_employer`, `contact_company` | Check a company or an agent, write to a company |
+| `register_agent`, `get_agent`, `agent_status`, `report_problem` | Your agent on Alion |
+
+Every argument is typed (`alion.types`), so your editor completes them and mypy or pyright check them.
+
+## For AI agents
+
+To give a model these tools directly, connect the MCP server instead of wrapping methods yourself:
+
+- remote clients (Claude, ChatGPT, Cursor, VS Code, the OpenAI Agents SDK, LangChain's `langchain-mcp-adapters`): `https://alion.io/mcp/open` without an account, `https://alion.io/mcp` with one;
+- clients that start a local command: `npx -y @alion-io/mcp`.
+
+## Links
+
+- Docs: https://alion.io/developers
+- JavaScript and TypeScript: [`@alion-io/sdk`](https://www.npmjs.com/package/@alion-io/sdk)
+- Source and issues: https://github.com/alion-io/alion-sdk
+- MIT license

alion-0.1.0/README.md

@@ -0,0 +1,128 @@
+# alion
+
+The official Python client for [Alion](https://alion.io/developers): a live graph of companies worldwide (what each one does, where it operates, its tech stack, funding rounds and investors, how fast it hires), startup investors, verified job postings with hiring and pay statistics, and people open to offers.
+
+Every tool of the [Alion MCP server](https://alion.io/developers/agents) is a typed method, sync or async. Python 3.9+. It uses only the standard library (plus `typing_extensions` before 3.11).
+
+```bash
+pip install alion
+```
+
+## Free without a key
+
+```python
+from alion import Alion
+
+alion = Alion()  # no key: the open address, free within a daily allowance
+
+companies = alion.search_companies(industry="Fintech", country="DE", startup=True, funding_stage="early", limit=10)
+for c in companies["items"]:
+    print(c["name"], c["domain"])
+
+match = alion.resolve_company(domain="stripe.com")["match"]
+jobs = alion.search_jobs(query="data engineer", country="PL", work_mode="remote")
+```
+
+Without a key you get compact company, investor and job searches, lookalike companies, full job postings, the people tools and the agent tools. The allowance is 300 calls a day per network, 30 a minute, and up to 20 rows per list.
+
+## Everything with a key
+
+Create a key at [alion.io/developers/keys](https://alion.io/developers/keys) and pass it, or set `ALION_API_KEY`:
+
+```python
+alion = Alion(api_key="...")
+
+stripe = alion.get_company(domain="stripe.com")          # funding, hiring, stack, offices, visa
+pay = alion.market_stats(role="Backend Developer", country="US")
+fund = alion.get_investor(domain="sequoiacap.com")
+```
+
+Calls with a key are paid from your account's credits. Prices are at [alion.io/developers](https://alion.io/developers).
+
+## Async
+
+```python
+from alion import AsyncAlion
+
+async with AsyncAlion() as alion:
+    jobs = await alion.search_jobs(query="rust", country="DE")
+```
+
+## Paging
+
+```python
+for company in alion.paginate("search_companies", technology="Snowflake", hiring=True, max_items=50):
+    print(company["name"])
+```
+
+The server stops a search at row 100. Narrow the filters to reach further.
+
+## Errors
+
+Every failure is an `AlionError` with a machine-readable `code`:
+
+```python
+from alion import AlionError
+
+try:
+    alion.get_company(domain="stripe.com")
+except AlionError as e:
+    e.code           # "account_required", "invalid_params", "rate_limited", "unauthorized", "timeout", ...
+    e.needs_account  # True when the tool needs a key or a payment
+    e.data           # the server's full answer: hints, free_tools, examples
+```
+
+Rate limits (429), network errors and server errors on read-only tools are retried twice with backoff by default.
+
+## Options
+
+```python
+Alion(
+    api_key="...",            # default: ALION_API_KEY; "" forces the open address
+    app_name="my-agent/1.0",  # added to the User-Agent so Alion can tell your agent apart
+    timeout=60.0,
+    max_retries=2,
+    headers={...},            # extra headers on every call
+    transport=my_transport,   # (url, headers, body, timeout) -> (status, headers, text), e.g. over httpx or requests
+)
+```
+
+Any tool can also be called by name, including tools added to the server after this release:
+
+```python
+alion.call("check_counterparty", {"target": "acme.com"})
+alion.list_tools()  # names, descriptions, input and output schemas
+```
+
+## Tools
+
+| Method | What it does |
+|---|---|
+| `search_companies` | Companies by industry, country, size, founding year, startup, funding stage, investor, technology, ATS, hiring and growth level |
+| `similar_companies` | Lookalikes of a company |
+| `get_company` | One company in depth: funding, hiring, stack, offices, visa sponsorship |
+| `resolve_company` | Which company a name or a domain means |
+| `search_investors`, `get_investor` | Funds, accelerators and angels: what they back, at which stage, how active now |
+| `search_jobs`, `get_job` | Verified job postings |
+| `market_stats` | Demand, pay percentiles, top employers and technologies of a role in a country |
+| `search_people`, `match_people`, `similar_people`, `get_person`, `check_fit` | People open to offers |
+| `send_message`, `get_conversation`, `list_conversations` | Write to people in Alion messages |
+| `watch_search`, `check_watch`, `list_watches`, `delete_watch`, `set_webhook` | Follow a search for new results |
+| `check_counterparty`, `check_employer`, `contact_company` | Check a company or an agent, write to a company |
+| `register_agent`, `get_agent`, `agent_status`, `report_problem` | Your agent on Alion |
+
+Every argument is typed (`alion.types`), so your editor completes them and mypy or pyright check them.
+
+## For AI agents
+
+To give a model these tools directly, connect the MCP server instead of wrapping methods yourself:
+
+- remote clients (Claude, ChatGPT, Cursor, VS Code, the OpenAI Agents SDK, LangChain's `langchain-mcp-adapters`): `https://alion.io/mcp/open` without an account, `https://alion.io/mcp` with one;
+- clients that start a local command: `npx -y @alion-io/mcp`.
+
+## Links
+
+- Docs: https://alion.io/developers
+- JavaScript and TypeScript: [`@alion-io/sdk`](https://www.npmjs.com/package/@alion-io/sdk)
+- Source and issues: https://github.com/alion-io/alion-sdk
+- MIT license

alion-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "alion"
+dynamic = ["version"]
+description = "Official Alion client: companies, startups, investors, job postings, hiring and pay statistics and people open to offers, as typed calls for code and AI agents. Free without a key for compact searches."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [{ name = "Alion", email = "info@alion.io" }]
+keywords = [
+  "alion", "company data", "company enrichment", "startups", "investors", "venture capital",
+  "funding rounds", "job postings", "jobs api", "labor market", "salary data", "tech stack",
+  "lookalike companies", "sales prospecting", "mcp", "model context protocol", "ai agents", "llm tools",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Internet :: WWW/HTTP",
+  "Topic :: Office/Business",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Typing :: Typed",
+]
+dependencies = ['typing_extensions>=4.7; python_version < "3.11"']
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "mypy>=1.10"]
+
+[project.urls]
+Homepage = "https://alion.io/developers"
+Documentation = "https://alion.io/developers"
+Source = "https://github.com/alion-io/alion-sdk"
+Issues = "https://github.com/alion-io/alion-sdk/issues"
+
+[tool.hatch.version]
+path = "src/alion/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/alion"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/alion", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = ["live: calls https://alion.io (run with -m live)"]
+addopts = "-m 'not live'"
+
+[tool.mypy]
+python_version = "3.9"
+strict = true

alion-0.1.0/src/alion/__init__.py

@@ -0,0 +1,29 @@
+"""Official Python client for Alion: companies, startups, investors, job postings, hiring and pay
+statistics, and people open to offers, for code and AI agents. https://alion.io/developers
+
+>>> from alion import Alion
+>>> alion = Alion()  # free without a key
+>>> alion.search_companies(industry="Fintech", country="DE", startup=True, limit=10)["items"]
+"""
+
+from . import _types as types
+from ._client import DEFAULT_BASE_URL, PROTOCOL_VERSION, Alion, AsyncAlion, Response, Transport, urllib_transport
+from ._errors import AlionError
+from ._types import PAGED_TOOLS, READ_ONLY_TOOLS, TOOL_NAMES
+from ._version import __version__
+
+__all__ = [
+    "Alion",
+    "AsyncAlion",
+    "AlionError",
+    "types",
+    "PAGED_TOOLS",
+    "READ_ONLY_TOOLS",
+    "TOOL_NAMES",
+    "PROTOCOL_VERSION",
+    "DEFAULT_BASE_URL",
+    "Response",
+    "Transport",
+    "urllib_transport",
+    "__version__",
+]