# Mirkaso

- **Event:** [Meta Global AI Developer Hackathon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon)
- **When:** Oct 26, 12:00 PM – Nov 4, 9:00 PM (EST)
- **Where:** Online
- **Team:** [Kyrylo Gaitan](https://cerebralvalley.ai/u/Kyrylo)
- **GitHub:** https://github.com/kirillgt84-cell/mirkaso-copilot
- **Demo video:** https://youtu.be/3w7Akt_5qs0?si=ylF8DdBhyb25_ZHg
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/163

Mirkaso Copilot is an agentic market assistant built on Meta's Muse Spark (muse-spark-1.3) via the Meta Model API. It runs inside Mirkaso (mirkaso.com), a live, bootstrapped crypto derivatives analytics platform with paying subscribers, built and run by a solo founder.

THE PROBLEM
Derivatives data (open interest, funding, scanner signals, sector rotation, macro regime) is spread across many screens. Answering a simple question like "which sector is overheating and why?" means opening several tabs and combining the numbers by hand. Most retail traders can't do that.

WHAT IT DOES
A trader asks a question in plain language. Muse Spark decides which tools to call, calls several in parallel, and writes a short answer based only on the results. The 4 tools read live Mirkaso data:
- Scanner signals (anomaly scoring over the top-150 USDT perpetual pairs)
- Sector indices
- Macro regime score and history
- Coin derivatives (price, open interest and their changes)

HOW WE KEEP IT HONEST
- Structured answers: numbers are resolved server-side from tool output, so the model doesn't type them freely.
- A numeric grounding guard checks the answer against tool results.
- Every answer shows its sources and an as-of time.
- If the data isn't available (for example a long/short ratio), Copilot says so instead of guessing.
- The existing output guard against advice-style wording stays in place.
- Tier-based gating and rate limits are decided by the host app, never by the model.

BUILT FOR PRODUCTION
Copilot is live on mirkaso.com/app behind subscription-tier limits; one answer costs about 2 cents. The agent loop has step, token and timeout limits, duplicate-call detection and structured errors that never leak internals. An EU forwarding proxy handles Meta API access from Europe.

ARCHITECTURE
Hybrid: the Copilot package (tools, Meta client, agent loop, grounding guard, demo CLI) is open source in this repo (MIT). It reads data through a DataProvider interface. The private Mirkaso product implements that interface, so the open package carries no business logic or secrets.

TIMELINE (declared honestly)
Before the hackathon: the Mirkaso platform itself (closed source), and an opt-in Meta provider in the private repo committed on Oct 26 at 12:32 UTC, before the kickoff ended. During the hackathon: this repository was created on Oct 26 at 18:38 UTC, after the kickoff, and all of its commits come later. In the private product repo from Oct 27: the data adapter, Copilot API behind a feature flag, chat panel, and production release.

NEXT
More tools (long/short ratios, ETF flows, options), multilingual answers, and an evaluation set that compares Muse Spark with our production model on accuracy, latency and cost.

## More from Meta Global AI Developer Hackathon

- [Muteko](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/160)
- [NIGHTRIDE](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/161)
- [PlateProof](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/162)
- [PNN_LSP](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/164)
- [Muse ServiceDesk](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/165)
- [Chalk Talk](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/166)

---

Markdown version of https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/163. Site index for agents: https://cerebralvalley.ai/llms.txt · full text: https://cerebralvalley.ai/llms-full.txt