# 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 with verifiable integrity.
> Flat pricing at $4.99/TB/month. No egress fees. 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 optimised 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 at any throughput 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://eu-west-1.s3.fil.one`
- **Region:** `eu-west-1`
- **Auth:** standard AWS Access Key ID + Secret Access Key

### Python (boto3)

```python
import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="https://eu-west-1.s3.fil.one",
    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://eu-west-1.s3.fil.one",
  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://eu-west-1.s3.fil.one
```

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

- **Verifiable data integrity** — every object receives a cryptographic fingerprint
  (CID) verified ~every 24 hours via Filecoin Proof of Spacetime (PoSt). Agent data
  cannot silently corrupt or disappear without detection.
- **No egress fees, no API request charges** — agents that read data frequently
  (retrieval loops, tool calls, eval pipelines) pay only for storage
- **Decentralised by default** — data is distributed across an independent network
  of Filecoin storage providers; no single-provider lock-in
- **11 nines of durability** by design

## Pricing

- **Pay-as-you-go:** $4.99/TB/month — no egress fees, no API request fees
- **Business plan:** custom pricing for enterprises; 1, 3, or 5-year terms with
  capacity assurance and deployment SLAs
- **Free trial:** 30 days, 1 TB included, no credit card required

## Pages

- [Homepage](https://www.fil.one): Product overview, feature comparison, pricing, and FAQ
- [Fil One for AI Agents](https://www.fil.one/lp/agents): Landing page for AI agent
  developers — S3-compatible storage at $4.99/TB flat, no egress fees, free 30-day
  trial. Covers agent use cases, code examples, and pricing.
- [Contact 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 full S3 API compatibility list
- [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