Metadata-Version: 2.4
Name: falcon-limitless-agent
Version: 0.1.0
Summary: Autonomous Limitless Exchange agent — Falcon signals, HMAC execution via Falcon API
Project-URL: Homepage, https://app.falconai.pro
Project-URL: Agent setup (app), https://app.falconai.pro/app/limitless/agents/client
Author: Falcon AI
License-Expression: MIT
Keywords: falcon,limitless,prediction-markets,sports,trading-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.11
Requires-Dist: colorlog<7,>=6.8
Requires-Dist: falcon-agent-webui>=0.1.0
Requires-Dist: flask-cors<6,>=4.0
Requires-Dist: flask<4,>=3.0
Requires-Dist: httpx<1,>=0.27
Requires-Dist: pydantic-settings<3,>=2.0
Requires-Dist: pydantic<3,>=2.0
Requires-Dist: python-dotenv<2,>=1.0
Requires-Dist: waitress<4,>=3.0
Requires-Dist: websockets<16,>=12.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: hatchling>=1.24; extra == 'dev'
Requires-Dist: pytest<9,>=8.0; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# Falcon Limitless Agent

Desktop client for **Limitless Exchange** copy signals and live execution.

| | |
|---|---|
| Dashboard port | **8070** |
| WebSocket provider | `limitless` |
| Falcon API base | `/api/v1/external/limitless` |

## What it does

1. Subscribes to Falcon personal copy signals (`providers: ["limitless"]`)
2. Applies bankroll, position-size, and daily-cap risk rules
3. **Dry-run** (default) logs intended trades without placing orders
4. **Live** posts orders via Falcon (`POST /orders`) using HMAC credentials stored in the Falcon app

## Quick start

```bash
cd client/falcon-limitless-client
python -m venv .venv
.venv\Scripts\activate          # Windows
# source .venv/bin/activate     # Mac/Linux
pip install -r requirements.txt
pip install -e .
copy .env.example .env          # fill FALCON_API_KEY
falcon-limitless-agent-check
falcon-limitless-agent
```

Or on Windows: `install.bat` → `check.bat` → `run.bat`

## Configuration

| Variable | Description |
|----------|-------------|
| `FALCON_API_KEY` | Falcon agent API key (Integration → API keys) |
| `FALCON_WS_URL` | Signal WebSocket (default `wss://api.falconai.pro/ws/signals`) |
| `FALCON_API_BASE` | Agent SDK base URL |
| `SIGNAL_PROVIDERS` | `limitless` |
| `DRY_RUN` | `true` (default) or `false` for live |
| `DASHBOARD_PORT` | `8070` |

Store **Limitless HMAC** credentials at [/app/limitless/agents/client](https://app.falconai.pro/app/limitless/agents/client) before setting `DRY_RUN=false`.

See also: `docs/CLIENT-ENV-REFERENCE.md` and `/downloads/LIMITLESS-CLIENT-ENV-REFERENCE.md`.

## PyPI

```bash
pip install falcon-limitless-agent
falcon-limitless-agent-check
falcon-limitless-agent
```
