Skip to content

deeprnd/tickoni

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9,488 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Tickoni β±οΈπŸ‘Ή

Build Quality Security
Unit Tests Integration Tests E2E Tests
HFT Engine Coverage AI Harness Coverage

Tickoni

High-throughput AI harness for agentic finance.

Fast runtime first. Agents second.

Tickoni turns AI agents into controlled, observable execution units running on a high-performance event engine.

For agentic finance, that means agents can inspect payment and accounting ledger events, prepare payment retries, propose ledger corrections, and recommend trading actions without receiving unrestricted control of a production system.

Generic harnesses ask whether an agent can read a file, call a tool, open a browser, or run a shell command.

Tickoni asks the financial questions:

  • Which payment rail, beneficiary, IBAN, wallet, broker account, or exchange is in scope?
  • Which ledger book, settlement batch, asset class, market, sector, side, and order type is allowed?
  • How much can the agent recommend or propose per case, day, month, destination, or instrument?
  • How frequently can it propose retries, transfers, corrections, or trades?
  • Which actions are observe-only, proposal-only, approval-required, or executable by a privileged path?

Built for:

  • ⚑ speed
  • 🧱 bounded financial authority
  • πŸ›‘οΈ destination, limit, and approval controls
  • πŸ”Ž case-level cost and consequence visibility
  • πŸ“œ forensic evidence
  • βͺ replay

AI models are probabilistic.

The systems running them should not be.

Why Tickoni?

Tickoni is named for tick and oni. The tick is the clock: every agent action advances on an explicit timeline you can measure, gate, and replay. The oni is the daemon: fast, tireless, and always executing. A powerful engine built for precision and control. Underneath, powered by Firedancer's trading-engine architecture, running a supercharged C-based event engine, Tickoni layers agent execution, embeddings, memory, and a plugin system on top of deterministic systems infrastructure.

Agents are getting more powerful.

The runtimes around them are still mostly:

prompt β†’ OS permission β†’ tool call β†’ response

Tickoni treats AI execution as a financial control-plane problem.

Every agent action becomes an event:

financial event β†’ capability envelope β†’ policy decision β†’ proposal or execution path β†’ evidence β†’ replay

The goal:

Know exactly:

  • what happened
  • why it happened
  • what financial consequence was proposed or attempted
  • which destination, limit, venue, account, or approval scope applied
  • how to reproduce it

No mystery state.

What You Get

Capability Description
⚑ Execution Engine High-throughput event runtime forked from Firedancer's systems core and evolved for AI workloads
🧱 Tile Runtime Small isolated execution units communicating through explicit shared-memory channels
πŸ€– Agent Harness Run payment, reconciliation, fraud, risk, and trading agents as controlled financial operators
πŸ› οΈ Financial Tool Broker Every adapter call is checked against payment, ledger, trading, risk, destination, and limit scope
πŸ›‘οΈ Capability Security Agents receive financial authority envelopes instead of broad tool or system access
πŸ”‘ Agent Identity Every action is bound to an agent role, workflow, case, policy version, and capability scope
πŸ“œ Evidence Engine Capture events, prompts, responses, adapter calls, proposals, approvals, failures, and decisions
βͺ Replay Capsules Reconstruct previous executions for debugging, testing, and verification
πŸ“Š Runtime Telemetry Monitor throughput, latency, queues, resources, capabilities, policies, costs, and failures
πŸ”Œ Model Agnostic Connect different model providers without coupling execution logic to the model
🧩 Extensible Runtime Add custom agents, signed financial adapters, policy templates, and execution tiles

Architecture

Tickoni is built on a high-throughput execution engine forked from Firedancer's systems core.

The original engine was designed around:

  • million TPS-class throughput goals
  • isolated execution components
  • shared-memory communication
  • predictable resource usage
  • low-level performance engineering

Tickoni evolves this foundation into an AI execution runtime.

Runtime

The runtime coordinates:

  • event flow
  • agent execution
  • financial adapter scheduling
  • state transitions
  • resource boundaries
  • destination, exposure, and approval boundaries

Everything is an event.

Everything has ownership.

Financial Control

Tickoni follows a tile-based execution model.

Each tile has:

  • one responsibility
  • owned state
  • bounded resources
  • explicit capabilities
  • controlled communication
  • observable execution

Tiles communicate through shared-memory channels.

Every interaction follows the same path:

agent β†’ financial capability check β†’ adapter/proposal path β†’ evidence β†’ replay

Model-native function calls and MCP-compatible tools terminate at the same broker boundary. The runtime treats protocol compatibility as an integration surface, not as permission to bypass policy.

Tickoni's capability model is finance-native. It can express constraints like:

  • payment retries only on approved rails and processors
  • ledger corrections as proposals, not postings
  • crypto transfers only to allowlisted wallets and networks
  • trading recommendations only for approved accounts, venues, sectors, and instruments
  • maximum notional per order, day, month, destination, customer, or portfolio
  • minimum order intervals and holding periods to prevent day-trading behavior
  • human approval before money-impacting execution

Every financial adapter call or proposal captures:

  • input
  • output
  • financial capability
  • destination and scope
  • limits and frequency checks
  • approval state
  • execution metadata
  • timing
  • resource usage
  • token usage
  • result

Allowed actions are recorded.

Denied actions are recorded too.

Built with Zig

Zig gives Tickoni:

  • clean Zig abstractions over high-performance C primitives
  • predictable execution with explicit memory and resource ownership
  • low-overhead runtime boundaries for agents, tools, and tiles
  • simple integration with sandboxing and isolation primitives

This keeps the message around the three pillars:

throughput β†’ consequence control β†’ replay

Evidence & Replay

Execution history is structured financial evidence, not log text.

Captured Purpose
⚑ Events Reconstruct execution flow
πŸ€– Agent runs Track every agent decision
🧠 Prompts Know exactly what context was provided
πŸ’¬ Model responses Inspect generated output
πŸ› οΈ Adapter calls See every payment, ledger, trading, risk, or compliance interaction
πŸ›‘οΈ Policy decisions Verify why actions were allowed, denied, or approval-required
πŸ’Έ Financial scope Record destination, account, rail, market, sector, instrument, and limit checks
πŸ”’ Token usage Measure cost by case, workflow, agent, and policy version
⏱️ Timing Track latency and bottlenecks
πŸ’Ύ State changes Understand what changed
❌ Failures Debug broken execution paths
βͺ Replay data Reproduce previous runs

Replay turns agent execution into a deterministic artifact:

previous input β†’ same environment β†’ comparable output

Debug behavior.

Measure changes.

Find divergence.

Observability

Expose the runtime:

  • throughput
  • latency
  • queues
  • execution time
  • resource usage
  • tool activity
  • policy decisions
  • failures
  • replay divergence

No black boxes.

Documentation

License

Apache-2.0

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • C 93.3%
  • Python 1.4%
  • SystemVerilog 1.3%
  • Zig 0.8%
  • Shell 0.7%
  • C++ 0.6%
  • Other 1.9%