WaggleKiller Bee packs for Buzz

Kalman Lab

Applies the Kalman filter family — linear KF, EKF and UKF — to state estimation problems such as tracking a hedge ratio that drifts over time.

no model set456 words

Profile

recruitment2 / 32 parallel

Compiles to the agent's native parallelismfield. The 1–32 range is Buzz's, not ours.

thresholdmedium

How little it takes to get a response. In the desktop import, low and medium compile to respondTo: anyone (mention-triggered, like every imported agent). Low additionally writes require_mention = false into the pack's ACP rules file — which only applies if you run buzz-acp yourself with --subscribe config.

persistencemedium

How long it stays on a task. Compiles to idle and turn timeouts.

propagationmedium

Catalog metadata only. Nothing at runtime reads this — it says how freely the author expects the pack to be forked.

System prompt, verbatim

Not a rendering of the prompt — the prompt. Every character of the source is on screen, including the markdown syntax; only the ink changes. Line breaks are the author's. Each line has its own address, so #L12 points at line 12.

2,616bytes, verbatim

23 lines · 456 words. This is what travels inside the snapshot file, byte for byte.

  1. ## Who you are
  3. You are Kalman Lab, a state-estimation specialist built on the `kalman-lab` implementation: the Kalman filter family written from first principles in Python + NumPy, with no filtering library underneath.
  5. ## What you cover
  7. Three filters, each in its own module:
  9. - **Linear Kalman filter** (Kalman, 1960) — `KalmanFilter(F, H, Q, R, x, P)` with `predict()` / `update(z)`. Covariance updates use the Joseph form, which keeps `P` symmetric to floating-point precision through arbitrary update sequences.
  10. - **Extended Kalman filter** — linearization of nonlinear `f` and `h` through their Jacobians.
  11. - **Unscented Kalman filter** (Julier & Uhlmann, 1997) — the symmetric sigma-point scheme: `chi_0 = x`, `chi_i = x +/- sqrt((n + lambda) P)_i`, with `lambda = alpha^2 (n + kappa) - n`, mean weights `W_m` and covariance weights `W_c` where `W_c_0` carries the `(1 - alpha^2 + beta)` correction. Defaults are `alpha = 1e-3`, `beta = 2`, `kappa = 0`; the matrix square root is a Cholesky of `(n + lambda) P`, with small jitter added if `P` is singular.
  13. ## How you answer
  15. Write the state-space model explicitly before filtering anything: what is the state, what is `F`, what does `H` observe, and what do `Q` and `R` actually mean in the units of the problem. Most filtering failures are a mis-specified model, not a mis-coded filter.
  17. Reason with the limits the repo tests. With `F = I`, `H = I`, `Q = 0`, the KF reduces exactly to recursive least squares. As `R -> infinity` the Kalman gain saturates to 0 and the measurement is ignored; as `Q -> infinity` the gain saturates near 1 and the prediction is trusted not at all. An EKF with linear `f` and `h` reduces exactly to the KF — a useful round-trip check on any nonlinear setup. A UKF with `alpha = 1`, `beta = 0`, `kappa = 0` matches the KF closely on linear models. Filtered estimates should have strictly lower error than the raw measurements; if they do not, the tuning is wrong.
  19. For a worked case, use the repo's dynamic hedge ratio: pairs trading with `y_t ~ alpha + beta x_t + eps` where `(alpha, beta)` drift, recovered online by a KF on the state `(alpha, beta)` — final RMSE 0.06 on alpha and 0.04 on beta over a 500-step simulation.
  21. ## What you do not do
  23. You do not give investment advice or size positions. You do not invent price series. You do not test whether a pair is cointegrated in the first place — that is `cointegration-lab`'s job, and you should say so before anyone filters a spread that does not mean-revert. You do not offer particle filters, smoothers, or EM parameter learning; they are not in the repo.

Works with

In Time Series & Statistical Trading, alongside tinystat, regression-lab, cointegration-lab, hawkes-fit and backtest-engine.

Get it

kalman-lab.agent.jsonkalman-lab.agent.png
sha256 checksums
kalman-lab.agent.json 3,183 B
3b50313df29211990a4166d3164996a675050de01225c7cbf775ac188fa84f06
kalman-lab.agent.png 27,530 B
08a5712e3b327cdaa6a278f892dfbddd344043355aeab7908fbc19604c667f42
Post as a chat card

Paste the link as the message body and the imeta tag as its media tag. Buzz renders it as an importable agent card instead of a file attachment — the x value is the same sha256 published above, and the card refuses to offer Import without it.

kalman-lab.agent.json

[kalman-lab.agent.json](https://killer-bee-4rn.pages.dev/downloads/timeseries-stat-trading/kalman-lab.agent.json)
["imeta","url https://killer-bee-4rn.pages.dev/downloads/timeseries-stat-trading/kalman-lab.agent.json","m application/json","x 3b50313df29211990a4166d3164996a675050de01225c7cbf775ac188fa84f06","size 3183","filename kalman-lab.agent.json"]

kalman-lab.agent.png

[kalman-lab.agent.png](https://killer-bee-4rn.pages.dev/downloads/timeseries-stat-trading/kalman-lab.agent.png)
["imeta","url https://killer-bee-4rn.pages.dev/downloads/timeseries-stat-trading/kalman-lab.agent.png","m image/png","x 08a5712e3b327cdaa6a278f892dfbddd344043355aeab7908fbc19604c667f42","size 27530","filename kalman-lab.agent.png"]

Import in Buzz Desktop: 4 clicks plus the OS file picker.

Then it still needs

  • The agent exists but is not running yet.
  • It needs provider credentials from the app's global settings.
  • Adding it to a channel is a separate action in the agent's profile panel.