kingchenc
9309bf9d60
The documentation now lives in the wickra-lib/wickra-docs VitePress repo and
will deploy to docs.wickra.org. Rewrite every tracked, user-facing wiki link
in the main repo to the new canonical site:
- docs/README.md, CONTRIBUTING.md, PULL_REQUEST_TEMPLATE.md
- bindings/{node,python,wasm}/README.md, examples/wasm/README.md
- repo-metadata.toml: wiki_url/wiki_git -> docs_url/docs_git
Page paths map 1:1 to VitePress clean URLs (e.g. /wiki/Quickstart-Rust.md ->
docs.wickra.org/Quickstart-Rust). The sync-about.yml wiki-sync step is left
untouched on purpose: it stays until the docs site is live (tracked as P8.3).
The GitHub wiki itself is not deleted yet for the same reason.
73 lines
3.0 KiB
Markdown
73 lines
3.0 KiB
Markdown
# Wickra — Python
|
|
|
|
[](https://github.com/wickra-lib/wickra/actions/workflows/ci.yml)
|
|
[](https://codecov.io/gh/wickra-lib/wickra)
|
|
[](https://pypi.org/project/wickra/)
|
|
[](https://github.com/wickra-lib/wickra/blob/main/LICENSE)
|
|
|
|
**Streaming-first technical indicators for Python. `pip install wickra` — no
|
|
system dependencies, no C build tooling.**
|
|
|
|
Wickra is a multi-language technical-analysis library with a Rust core and
|
|
bindings for Python, Node.js, and WebAssembly. Every indicator is an O(1)
|
|
streaming state machine, so live trading bots and historical backtests share
|
|
the exact same implementation. This package is the Python binding (PyO3); it
|
|
exposes 200+ streaming-first indicators across sixteen families.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
pip install wickra
|
|
```
|
|
|
|
Pre-built wheels ship for Linux, macOS, and Windows — there is nothing to
|
|
compile and no C library to track down.
|
|
|
|
## Quick start
|
|
|
|
```python
|
|
import numpy as np
|
|
import wickra as ta
|
|
|
|
# Batch: classic TA-Lib-style usage over a whole array.
|
|
prices = np.linspace(100, 200, 1000)
|
|
rsi = ta.RSI(14)
|
|
values = rsi.batch(prices) # numpy array, NaN during warmup
|
|
|
|
# Streaming: the same indicator, fed tick by tick in O(1).
|
|
rsi = ta.RSI(14)
|
|
for price in live_feed:
|
|
value = rsi.update(price) # no recomputation over history
|
|
if value is not None and value > 70:
|
|
print("overbought")
|
|
```
|
|
|
|
`batch(prices)` and feeding the same prices through `update()` produce
|
|
identical values — the equivalence is enforced by the test suite.
|
|
|
|
## Documentation
|
|
|
|
The full indicator catalogue, guides, quickstarts, and API reference live in
|
|
the main repository and documentation site:
|
|
|
|
- **Repository & full indicator list:** <https://github.com/wickra-lib/wickra>
|
|
- **Docs** (quickstarts, cookbook, TA-Lib migration): <https://docs.wickra.org>
|
|
- **Runnable examples:** [`examples/python/`](https://github.com/wickra-lib/wickra/tree/main/examples/python)
|
|
|
|
Wickra ships four bindings — Python, Node.js, WebAssembly, and Rust — that all
|
|
expose the same indicators from the shared, `unsafe`-forbidden Rust core.
|
|
|
|
## Disclaimer
|
|
|
|
Wickra is an indicator toolkit, not a trading system. The values it computes
|
|
are deterministic transforms of the input data — they are not financial advice
|
|
and do not predict the market. Any use in a live trading context is at your own
|
|
risk. The library is provided **as is**, without warranty of any kind.
|
|
|
|
## License
|
|
|
|
Licensed under the **PolyForm Noncommercial License 1.0.0**. Personal projects,
|
|
research, education, non-profits, and hobby trading bots are all fine; the one
|
|
thing not allowed is commercial sale of the software or of services built
|
|
around it. See [LICENSE](https://github.com/wickra-lib/wickra/blob/main/LICENSE).
|