InferenceFS v1.0.0

The first release of InferenceFS — the long-awaited successor to πfs.

What is InferenceFS?

A FUSE filesystem that generates file contents on-the-fly using LLMs. Store only filenames and directory structure — the contents are inferred.

Features

• Multiple LLM backends: Google Gemini (recommended), Claude API, Claude Code CLI
• Full binary file support with correct magic bytes for PNG, JPEG, GIF, PDF, WAV, MP4, ELF, PE, and more
• LRU content cache with configurable memory limit
• Rate limit retry with backoff
• Written file sizes persisted across mount/unmount cycles
• Configurable max token limit for LLM responses

Install

pip install inferencefs

Quick Start

export API_KEY=your-gemini-key
mkdir -p /tmp/source /tmp/mount
inferencefs --backend gemini /tmp/source /tmp/mount
touch /tmp/mount/hello.py
cat /tmp/mount/hello.py