Neural

KO | EN

gitlite — search

#python #ai #go #android #linux #docker #macos #windows #cli #kubernetes #awesome-list #pytorch #openai #open-source

(★ 11)

Kalshi-first SDK for prediction market trading

Neural Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Neural SDK

[![PyPI version](https://badge.fury.io/py/neural-sdk.svg)](https://pypi.org/project/neural-sdk/)
[![Python Versions](https://img.shields.io/pypi/pyversions/neural-sdk.svg)](https://pypi.org/project/neural-sdk/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Deterministic prediction-market kernel for portable contracts, normalization,
replay, and paper-first integration beneath Vaticor.

[Documentation](https://github.com/IntelIP/Neural/tree/main/docs) | [Examples](./examples) | [Contributing](./CONTRIBUTING.md)

## Stable Kernel

The dependency-free stable surface lives at `neural.kernel`. Provider access,
strategy analysis, deployment, sentiment, and FIX helpers remain experimental
or deprecated compatibility modules.

## Install

Using `uv`:

```bash
uv add neural-sdk
uv add "neural-sdk[trading]"
```

Using `pip`:

```bash
pip install neural-sdk
pip install "neural-sdk[trading]"
```

Verify the stable installed surface without credentials or network access:

```bash
neural --json capabilities
neural --json replay demo
```

See [Stable Kernel and Compatibility](./docs/architecture/stability.mdx) for
the capability matrix, extras, and deprecation policy.

## CLI Bridge

The base install ships a `neural` CLI intended to be the stable machine-readable bridge for the TypeScript Neural TUI.

```bash
neural doctor
neural --json capabilities
neural --json providers list
```

Current bridge commands:
- `doctor`
- `capabilities`
- `replay demo`
- `providers list`
- `markets list`
- `quote`
- `positions`
- `paper order`
- `deployments list`
- `deployments status`
- `deployments logs`
- `deployments stop`

## Highlighted Examples

- [examples/09_daily_nba_markets.py](./examples/09_daily_nba_markets.py): public Kalshi NBA market snapshot with sports-aware parsing.
- [examples/10_daily_nba_markets_polymarket.py](./examples/10_daily_nba_markets_polymarket.py): public Polymarket US NBA market snapshot using the normalized market interface.
- [examples/12_cross_provider_analysis_bridge.py](./examples/12_cross_provider_analysis_bridge.py): live cross-provider normalization plus one shared analysis pass.
- [examples/13_deterministic_cross_provider_replay.py](./examples/13_deterministic_cross_provider_replay.py): reproducible replay proving the analysis stack generates `buy_yes`, `buy_no`, and `hold` decisions on standardized cross-provider data.

## Credentials

Create a `.env` file with your Kalshi credentials:

```bash
KALSHI_API_KEY_ID=your_api_key_id
KALSHI_PRIVATE_KEY_BASE64=base64_encoded_private_key
KALSHI_ENV=prod
```

The SDK loads credentials from environment variables or your local secrets files.

## Development

```bash
git clone https://github.com/IntelIP/Neural.git
cd neural
uv sync --extra dev --extra trading --extra sentiment --extra analysis --extra deployment
uv run pytest
uv run ruff check .
uv run black --check .
```

## Testing

```bash
uv run pytest
uv run pytest --cov=neural tests/
```

## Resources

- Documentation: [docs/](./docs/index.mdx)
- Examples: [examples/](./examples)
- Issues: [GitHub Issues](https://github.com/IntelIP/Neural/issues)
- Discussions: [GitHub Discussions](https://github.com/IntelIP/Neural/discussions)

## License

This project is licensed under the MIT License. See [LICENSE](./LICENSE).

Neural

Neural Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Neural

Neural Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README