What It Is
ChatGPT, but for candlesticks
You know how ChatGPT looks at all the words before and predicts the next one? Kronos does the exact same thing, but with candlesticks.
It was trained on market data from over 45 global exchanges. It learned the patterns of how prices move, and now it predicts the next move the same way a language model predicts the next word. That is the whole trick. The thing that autocompletes your texts can autocomplete a chart.
Under the hood there are two parts. A tokenizer turns raw candle data (open, high, low, close, volume) into tokens the model can read. Then a transformer reads the recent history and forecasts what comes next. You feed it a chart, it hands you a predicted path.
Why It's a Big Deal
This isn't a weekend hobby project
It would be easy to wave this off as another random GitHub repo. It is not. Here is why people who do this for a living are paying attention.
27.9k
GitHub stars, and climbing fast. This is one of the most-starred finance AI projects out there.
AAAI 2026
Accepted to one of the biggest AI research conferences in the world. Peer-reviewed, not hype.
45+
Global exchanges in the training data. It has seen how a lot of different markets actually move.
MIT
Open-source license. Free to use, free to modify, free to build a product on. No catch.
Want to see it before you install anything? The team put up a live demo forecasting BTC 24 hours out. Watch the predicted line track the real one. That is the moment it stops feeling like a toy.
Read This First
It's not a money printer
Let me kill the fantasy before you build it in your head. Kronos is not going to make you rich while you sleep. It is a forecasting tool, not a crystal ball. The repo authors say it plainly: this is a research model, not a production trading system. The predictions it spits out are raw signals, and markets get moved by news, costs, and slippage that no model on its own accounts for.
So who is this actually for? Anyone who already works near markets. If you trade, invest, do analysis, or touch finance in your day job, a free model trained on 45 exchanges is an absurdly good thing to have in your back pocket. The story here is not "easy money." The story is that one research team gave away tech that quants get paid a fortune to build, and it is good enough to make them nervous.
Best Use Cases
Where it actually earns its keep
You trade or invest
Use it to pressure-test a thesis. You think a stock runs this month. What does a model trained on 45 exchanges think? It is a second opinion, not a signal.
You work in finance
Forecasting, scenario planning, and risk reads are half the job. Kronos gives you a free baseline forecast you can drop into a deck or a model in minutes.
You are quant-curious
This is the cleanest way to see how a transformer actually forecasts a market. The whole pipeline is open. Read it, break it, learn from it.
You build tools
It is an MIT-licensed model you can wire into a dashboard, a Discord bot, or an internal app. No API bill, no rate limits, no vendor.
Set It Up
The no-code way: let Claude do it
Kronos runs in Python. If that sentence already lost you, good news: you never have to touch Python yourself. Open Claude Code, paste the prompt below, and it will install everything, pull live market data, and run your first forecast while explaining each step in plain English. If it hits an error, it reads it and fixes it on its own.
The only thing you need first is Claude Code installed. Then open a session in any empty folder and paste this:
Copy-paste prompt
I want to set up Kronos, the open-source AI model that forecasts financial markets, and run my first forecast. I am not a developer, so do everything for me and explain each step in plain English as you go. Here is the repo: https://github.com/shiyu-coder/Kronos Please: 1. Check that I have Python 3.10 or newer installed. If I don't, tell me exactly how to install it for my operating system. 2. Clone the Kronos repo into a new folder called "kronos" in my current directory. 3. Create a virtual environment inside it and install everything in requirements.txt, plus yfinance so we can pull real market data. 4. Write a script called forecast.py that: - Downloads the last 400 daily candles for a ticker I choose (default: AAPL) using yfinance - Loads the Kronos-small model and the Kronos-Tokenizer-base from Hugging Face - Feeds in the historical open, high, low, close, and volume - Forecasts the next 30 trading days - Saves a chart called forecast.png that shows the real price history and the predicted path on the same plot 5. Run forecast.py and open forecast.png so I can see the result. If anything errors out, read the error, fix it yourself, and try again. Don't ask me to fix code. When you're done, tell me in plain English what the chart is showing, and remind me this is a forecast, not financial advice.
The models download from Hugging Face the first time, so the first run takes a few minutes. After that it is fast. Start with Kronos-small. It is plenty for getting a feel for it.
If You Code
The manual way
Prefer to drive it yourself? Clone the repo, install the requirements (Python 3.10 or newer), and run this. It loads the model, pulls 400 days of Apple candles, and forecasts the next 30 trading days.
Quick-start script
from model import Kronos, KronosTokenizer, KronosPredictor
import pandas as pd
import yfinance as yf
# 1. Load the model (downloads from Hugging Face the first time)
tokenizer = KronosTokenizer.from_pretrained("NeoQuasar/Kronos-Tokenizer-base")
model = Kronos.from_pretrained("NeoQuasar/Kronos-small")
predictor = KronosPredictor(model, tokenizer, max_context=512)
# 2. Pull real market data (last 400 daily candles for Apple)
df = yf.download("AAPL", period="400d", interval="1d").reset_index()
df.columns = [c.lower() for c in df.columns]
lookback = 400
pred_len = 30
x_df = df.loc[:lookback - 1, ['open', 'high', 'low', 'close', 'volume']]
x_timestamp = df.loc[:lookback - 1, 'date']
y_timestamp = pd.date_range(x_timestamp.iloc[-1], periods=pred_len + 1, freq='B')[1:]
# 3. Forecast the next 30 days
pred_df = predictor.predict(
df=x_df,
x_timestamp=x_timestamp,
y_timestamp=y_timestamp,
pred_len=pred_len,
T=1.0,
top_p=0.9,
sample_count=1,
)
print(pred_df) Model options, smallest to largest: Kronos-mini (4.1M params, 2048 context), Kronos-small (24.7M), and Kronos-base (102.3M). Bigger is slower, not always better. Start small.
Starter Prompts
5 ways to actually use it
Once it is running, you steer everything by talking to Claude. No editing code by hand. Paste any of these to take it further. The backtest one is the one to try first. It shows you how close the model actually got.
Copy-paste prompts
1. Change the ticker and timeframe "Edit forecast.py to forecast TSLA on the hourly chart instead of AAPL daily. Pull the last 512 hourly candles and forecast the next 48 hours." 2. Backtest it against reality "Re-run the forecast, but cut off the data 30 days ago. Then plot the forecast against what actually happened over those 30 days so I can see how close it got." 3. Compare a basket of tickers "Run the forecast for AAPL, NVDA, MSFT, and AMZN. Make one chart per ticker and tell me which one Kronos expects to move the most over the next 30 days." 4. Read the volatility, not just the price "Run the forecast with sample_count set to 30 so we get a range of possible paths. Shade the area between the highest and lowest paths so I can see how uncertain the model is." 5. Upgrade to the bigger model "Swap Kronos-small for Kronos-base and re-run the same forecast. Tell me if the prediction changed and roughly how much slower it was."
Credit Where It's Due
I didn't build this
Kronos was built by Yu Shi, Zongliang Fu, Shuo Chen, and their collaborators, and released open-source for anyone to use. The full model, the tokenizer, the training pipeline, all of it is public. If you want to go deep, the research paper is on arXiv.
That is the real story. One research team gave away tech that hedge funds pay a fortune to build. The least we can do is point you straight to the source.
Star it, fork it, read the code:
View on GitHubWork with Me
Need AI to actually work for your business?
I help businesses cut through the AI hype and build the workflows, automations, and systems that actually move the needle. Direct, hands-on, no fluff.
Work with me