Skip to main content

Start with one question

1

Install Fella

Download the latest published installer from GitHub Releases. This guide describes the v0.4.0 workspace; older installed versions may differ.
2

Connect a model provider

Open Settings, choose a provider, and add your own API key. Fella is BYOK-only. After connecting, the composer shows the selected model; choose a different available model there when needed.
3

Open a folder

Use the workspace switcher in the title bar to choose a folder. This folder is the explicit data boundary for file-backed analysis. Fella catalogs supported sources locally.
4

Review Files

Select Files in the left sidebar to browse the folder hierarchy, see which files were cataloged, and open supported previews. Check skipped files before relying on an answer.
5

Ask in Chat

Return to Chat and ask a specific question. For example: “Using orders.csv, compare net sales by month for 2024 and 2025, and explain the largest change.”
6

Inspect or preserve the work

Open How this was analyzed below a response for the run details. Open Notebook to create or review a persistent Investigation, or choose Create report to save a useful output.

Supported inputs

Fella does not edit, move, or delete source files. It does not currently provide DOCX or PPTX ingestion, OCR, or general-purpose previews for every file format. A table preview is a small sample, not a workbook viewer.

What answers can contain

For data-backed questions, the model chooses analysis steps and then composes a view suited to the saved results. The JSON-render component catalog supports narrative, metrics, tables, charts, callouts, and presentation-only controls. Charts are not required for every answer; they are appropriate when they make a trend, comparison, ranking, distribution, or relationship easier to understand. The answer remains useful if the model cannot produce a valid structured view: Fella keeps the canonical answer and the analysis details available. See Ask questions and Reports.

A useful question pattern

State the measure, population, period, and comparison when they matter. You do not need to choose SQL, Python, or a chart:
Compare net merchandise revenue for Q3 and Q4. Explain the metric, identify the largest category changes, and note any source limitations.
If the answer matters, inspect its source scope, computations, and verification checks. A successful query is not proof that its definition matched your intent.

Investigations

Turn a larger objective into persistent, reviewable work.

Privacy and security

Learn what stays local and what a connected provider receives.