{"id":50351138,"url":"https://github.com/kxsystems/aimeta","last_synced_at":"2026-05-29T21:01:34.781Z","repository":{"id":360182922,"uuid":"1244726453","full_name":"KxSystems/aimeta","owner":"KxSystems","description":"[WIP] kdb-x module for metadata and AI metadata discovery","archived":false,"fork":false,"pushed_at":"2026-05-22T16:51:18.000Z","size":155,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-25T12:05:30.433Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"q","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KxSystems.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-20T14:36:04.000Z","updated_at":"2026-05-22T16:55:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/KxSystems/aimeta","commit_stats":null,"previous_names":["kxsystems/aimeta"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/KxSystems/aimeta","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KxSystems%2Faimeta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KxSystems%2Faimeta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KxSystems%2Faimeta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KxSystems%2Faimeta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KxSystems","download_url":"https://codeload.github.com/KxSystems/aimeta/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KxSystems%2Faimeta/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33670211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-29T21:01:33.691Z","updated_at":"2026-05-29T21:01:34.775Z","avatar_url":"https://github.com/KxSystems.png","language":"q","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aimeta\n\n`aimeta` is a q module that defines an extended metadata model for kdb+ tables and functions, and a compiler that populates the model from qdoc-style annotations in `.q` source. The model is served over HTTP (`/meta`) and qIPC (`.aimeta.get*`) for operators and AI coding agents to consume.\n\n## Why\n\n- **An extended metadata model for kdb+ tables and functions.** Captures column descriptions, semantic types, foreign-reference edges, working call examples, parameter and return docs, and inline sample data — the semantic detail an operator or agent needs to write correct queries that native `meta` and `tables[]` don't carry.\n- **Annotations populate the model.** qdoc-style tags in `.q` source compile to a canonical `meta.json` — one annotation pass yields both a developer-readable source and a machine wire format. The compiler validates against 13 rules at build time, and the output is byte-deterministic, so the JSON is safe to commit as a build artifact.\n- **Self-describing over HTTP and qIPC, with graceful fallback.** Operators and AI coding agents probe a host to read the model. The bundled `kx-meta` CLI walks from rich annotated metadata down to bare introspection, so it works against unannotated processes too. Compile runs at startup; if it fails or the source isn't annotated, `init[]` falls back through existing `meta.json` → basic introspection → empty document. The host stays up; consumers get the metadata that is available.\n\n## Quickstart\n\n```q\n/ host.q\naimeta: use `kx.aimeta;\n\n/ @kind data\n/ @name trade\n/ @desc Trade tape — every fill, raw, append-only.\n/ @col time {timestamp} Wall-clock fill time.\n/ @col sym {symbol} Instrument symbol. @attr:g\n/ @col price {float} Fill price in instrument's quote currency.\n/ @col size {int} Fill size in shares.\ntrade: ([] time:`timestamp$(); sym:`symbol$(); price:`float$(); size:`int$())\n@[`trade;`sym;`g#];\n\n/ @kind function\n/ @name .gw.vwap\n/ @desc Volume-weighted average price for the given symbols.\n/ @param syms {symbol[]} Symbols to compute VWAP for.\n/ @uses trade\n/ @returns {table} sym-keyed VWAP.\n/ @example .gw.vwap[`AAPL`MSFT]\n.gw.vwap: {[syms] select vwap:size wavg price by sym from trade where sym in syms}\n\n\\p 5013\naimeta.init[];                          / compiles annotations + serves /meta\n```\n\n```bash\ncurl localhost:5013/meta\nscripts/kx-meta.sh discover localhost:5013\n```\n\n## Documentation\n\n- [docs/install.md](docs/install.md) — installation, host wiring, `kx-meta` CLI, Claude Code skills\n- [docs/reference.md](docs/reference.md) — per-symbol API reference and HTTP surface\n- [docs/agent-guide.md](docs/agent-guide.md) — metadata guide for agents authoring or consuming `meta.json`\n- [SPEC.md](SPEC.md) — annotation standard, runtime model, `meta.json` schema\n\nHacking on the module itself? See [CONTRIBUTING.md](CONTRIBUTING.md) and [CLAUDE.md](CLAUDE.md).\n\n## Status\n\nPre-1.0. Public surface is stable and versioned by `schemaVersion`.\n\n## Related\n\n- [KxSystems/ax](https://github.com/KxSystems/ax) — open-source qdoc parser used by the compiler\n\n## License\n\nApache-2.0. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkxsystems%2Faimeta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkxsystems%2Faimeta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkxsystems%2Faimeta/lists"}