← Back to Free Stuff

Free Guide — June 2026

Set Up Kronos

Kronos is the first open-source AI model built to forecast financial markets. The same kind of tech a hedge fund pays millions for is sitting on GitHub for free. This is how you set it up and run your first forecast, even if you have never written a line of code. One honest warning up front: this is a forecasting tool, not a money printer.

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 GitHub

Work 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