# Fil One

> Fil One is the storage layer for AI agents. S3-compatible object storage built
> on Filecoin, designed for the data patterns of autonomous agents: high-frequency
> writes, large retrieval sets, and long-lived persistence.
> Flat pricing at $5.99/TB/month. No egress penalties. No per-request charges.
> Free 30-day trial, no credit card required.

## Why AI agents use Fil One

AI agents need durable, cost-predictable storage for the artifacts they produce and
consume. Fil One is optimized for these workloads:

- **RAG / vector store document corpus:** store and retrieve the raw documents,
  chunked text, or embeddings backing a retrieval-augmented generation pipeline
- **Agent memory and state:** persist conversation history, episodic memory, task
  queues, and checkpoint files across agent restarts
- **Model artifacts:** host fine-tuned weights, GGUF/ONNX model files, LoRA
  adapters, and tokenizer configs that agents load at runtime
- **Inference inputs and outputs:** archive prompts, completions, traces, and
  structured outputs for evaluation, fine-tuning, or audit
- **Training and evaluation datasets:** store JSONL, Parquet, or HDF5 datasets;
  read them back as often as you need with no egress cost
- **Tool / plugin asset storage:** back a code-interpreter sandbox, image
  generation pipeline, or document-processing tool with persistent file storage

## How to connect

Fil One is a drop-in S3 replacement. No SDK changes required: point any existing
S3 client at the Fil One endpoint:

- **Endpoint:** `https://s3.eu-west-1.filonecontent.com`
- **Region:** `eu-west-1` (Europe, France; default). `us-east-1` (US East, Michigan)
  is also available at `https://s3.us-east-1.filonecontent.com`
- **Auth:** standard AWS Access Key ID + Secret Access Key
- **Addressing:** path-style only; virtual-hosted-style is not supported

### Python (boto3)

```python
import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="https://s3.eu-west-1.filonecontent.com",
    aws_access_key_id="YOUR_ACCESS_KEY",
    aws_secret_access_key="YOUR_SECRET_KEY",
    region_name="eu-west-1",
)

# Upload an agent checkpoint
s3.upload_file("checkpoint.json", "my-agent-bucket", "checkpoints/run-42.json")

# Retrieve a RAG document
obj = s3.get_object(Bucket="my-agent-bucket", Key="corpus/doc-001.txt")
text = obj["Body"].read().decode()
```

### Node.js (@aws-sdk/client-s3)

```javascript
import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";

const s3 = new S3Client({
  endpoint: "https://s3.eu-west-1.filonecontent.com",
  region: "eu-west-1",
  credentials: {
    accessKeyId: process.env.FIL_ONE_ACCESS_KEY,
    secretAccessKey: process.env.FIL_ONE_SECRET_KEY,
  },
});

await s3.send(new PutObjectCommand({
  Bucket: "my-agent-bucket",
  Key: "memory/session-abc123.json",
  Body: JSON.stringify(agentMemory),
}));
```

### AWS CLI

```bash
aws s3 cp ./dataset.parquet s3://my-agent-bucket/datasets/train.parquet \
  --endpoint-url https://s3.eu-west-1.filonecontent.com
```

## Key differentiators vs AWS S3, Backblaze B2, Wasabi, and Cloudflare R2

- **No egress penalties, no API request charges:** agents that read data frequently
  (retrieval loops, tool calls, eval pipelines) pay only for storage
- **Independent regional operators:** each region is run by an independent storage
  operator, and the standard S3 API means no lock-in
- **Object lock and versioning:** governance or compliance retention, set at bucket
  creation, alongside versioning
- **Designed for 11 nines of durability**

## Pricing

- **Pay as you go:** $5.99/TB/month, no egress penalties (subject to reasonable use), no API
  request or retrieval fees
- **Monthly minimum:** $5.99
- **Reserved capacity:** custom pricing; 1, 3 or 5-year terms with capacity
  assurance and deployment SLAs, guided migration and invoicing
- **Free trial:** 30 days, 1 TB storage and 2 TB egress included, no credit card
  required. Upgrade to a paid plan to keep downloading after the egress allowance

## Pages

- [Homepage](https://www.fil.one): Product overview, feature comparison, pricing, and FAQ
- [Pricing](https://www.fil.one/pricing): Flat per-TB rate, a cost calculator
  comparing Fil One with AWS S3, Wasabi, Backblaze B2 and Cloudflare R2, and a billing FAQ
- [Bring a workload](https://www.fil.one/workloads): AI training and models, data lakes
  and ETL, backup and archive, media, and security logs
- [Host a zone](https://www.fil.one/host): S3 object storage installed in a GPU
  cloud's own facility, sold under the partner's brand
- [Partners](https://www.fil.one/partners): One partner program with four roles: channel,
  technology, managed service and data center (Host a zone)
- [About](https://www.fil.one/about): The team and company behind Fil One
- [Talk to sales](https://www.fil.one/contact-sales): Enterprise and high-volume inquiries;
  also reachable at sales@fil.one

## Docs

- [Full documentation](https://docs.fil.one): Quickstart, S3 compatibility reference,
  SDK examples, API reference, security, billing, and limits

## Optional

- [Full reference for AI agents and developers](https://www.fil.one/llms-full.txt): SDK
  examples, architecture patterns, multipart upload, presigned URLs, PyArrow/fsspec
  integration, and the supported S3 operations with regional caveats
- [Privacy Policy](https://www.fil.one/privacy): Data handling and privacy practices
- [Terms of Service](https://www.fil.one/terms): Terms governing use of the platform