⚠️ Work in Progress: This project is actively being developed. Features, structure, and documentation may change frequently.
Floki is named after the legendary Viking engineer Flóki Vilgerðarson, who built innovative boats that enabled Vikings to explore new lands. This project aims to empower ML researchers to explore their experiment logs with the same spirit of discovery.
A CLI-based assistant for ML experimentation, inspired by Claude Code, that helps researchers query, analyze, and gain insights from MLflow experiment logs.
Quick Setup
- Create and activate an environment
Option A — Conda (recommended):
conda env create -f environment.yml -n floki-agent
conda activate floki-agentOption B — venv + pip:
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt- Add required API keys
Create a .env file in the project root or export the variables into your shell. The agent expects at least the following keys:
GROQ_API_KEY=your_groq_api_key_here
LANGFUSE_PUBLIC_KEY=your_langfuse_api_key_here
LANGFUSE_SECRET_KEY=your_langfuse_api_key_here
LANGFUSE_BASE_URL="https://us.cloud.langfuse.com"
- Run the agent or scripts
Start the main agent (project includes run_agent.sh):
bash run_agent.sh