> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# GitHub dataset repos

> Import common CSV, JSON, JSONL, TSV, YAML, XML, and Parquet files from public GitHub repositories.

Arka can import data files from public GitHub repositories without needing a
custom skill for each repo. It downloads the repository archive, extracts common
data formats, caches them locally, and writes a manifest with file previews.

```bash theme={null}
arka github-dataset import hasaneyldrm/exercises-dataset --timeout 600
arka github-dataset status hasaneyldrm/exercises-dataset
arka github-dataset search hasaneyldrm/exercises-dataset chest
```

Natural language routes to the same importer:

```bash theme={null}
arka quickly add data from this repo https://github.com/owner/dataset-repo
arka import csv files from github.com/owner/data-repo
arka search github dataset owner/repo for ratings
```

## What Arka extracts

The generic importer scans the repo archive for:

* `.csv`
* `.json`
* `.jsonl` / `.ndjson`
* `.tsv`
* `.yaml` / `.yml`
* `.xml`
* `.parquet`

It skips obvious build and dependency folders such as `node_modules`, `.git`,
`venv`, `dist`, and `build`.

## Cache location

Imported files are stored under:

```text theme={null}
~/.cache/fish-agent/datasets/github/<owner>__<repo>/files/
~/.cache/fish-agent/datasets/github/<owner>__<repo>/manifest.json
```

The manifest includes source URL, branch, cached file paths, file sizes, and
best-effort previews such as CSV columns or JSON keys.

## Licensing

Arka does not infer a repository's license or redistribution rights. Before
using imported data in a product, dataset, demo, or public export, inspect the
upstream repository's license and README.

For heavily curated sources, Arka may still provide a named preset such as
`arka exercises`; those presets can add domain-specific normalization on top of
the generic GitHub dataset importer.


## Related topics

- [GitHub Actions](/guides/github-actions.md)
- [Quickstart: install Arka and run your first command](/quickstart.md)
- [How to code with Arka](/guides/code-with-arka.md)
- [Skills catalog: 70+ built-in Arka commands](/guides/skills.md)
- [Arka — AI terminal agent documentation](/index.md)
