easybits

# EasyBits

La nube para agentes de IA: sandboxes (microVMs Firecracker), web (buscar, leer, extraer), archivos, bases de datos SQL, documentos, hosting de apps y agentes en WhatsApp — desde un solo MCP, una REST API v2 y un SDK tipado. Precios en MXN, con plan gratuito.

[easybits.cloud](https://www.easybits.cloud)

## MCP Server

```bash
npx -y @easybits.cloud/mcp
```

Un solo endpoint con todo el catálogo: sandboxes, web (buscar, leer, extraer), archivos, bases de datos SQL, documentos, video y hosting. El conteo vive en [`/api/tools.json`](https://www.easybits.cloud/api/tools.json), derivado del servidor — nunca escrito a mano.

## SDK

```bash
npm install @easybits.cloud/sdk
```

## Get your API key

1. [Sign up](https://www.easybits.cloud/login) for a free EasyBits account
2. Go to the [Developer Dashboard](https://www.easybits.cloud/dash/developer) → **API Keys** → **Create Key**
3. Your key looks like `eb_sk_live_...` — copy it and store it safely. You won't see it again.

Use the key as a Bearer token (REST API), via `EASYBITS_API_KEY` env var (MCP), or in the SDK constructor. Full docs at [easybits.cloud/docs](https://www.easybits.cloud/docs).

## AI Landing Generator

```bash
npm install @easybits.cloud/html-tailwind-generator
```

AI-powered landing page generator with Tailwind CSS — canvas editor, streaming generation (Claude), image enrichment (DALL-E / Pexels), one-click deploy. [README →](./packages/html-tailwind-generator/README.md)

```typescript
import { EasyBits } from "@easybits.cloud/sdk";
const eb = new EasyBits({ apiKey: "eb_..." });
const file = await eb.files.upload({ name: "photo.jpg", contentType: "image/jpeg" });
```

## Features

- **File management** — upload, transform, optimize, soft-delete with trash retention
- **Websites** — deploy static sites to `slug.easybits.cloud` with custom domains
- **Presentations** — AI-generated reveal.js slides with 3D scenes, deploy to subdomain
- **Landing pages v2** — AI-generated block-based pages with streaming SSE, stock photos, visual variants
- **Landing pages v3** — free-form HTML canvas editor, Sonnet generation, Haiku refine, semantic color themes, code editor. **Production-ready**, exported as [`@easybits.cloud/html-tailwind-generator`](https://www.npmjs.com/package/@easybits.cloud/html-tailwind-generator) npm package — used by [Denik](https://denik.me)
- **Webhooks** — real-time event notifications with HMAC signatures
- **IAM** — scoped API keys (READ, WRITE, DELETE, ADMIN), file-level sharing

## Stack

React Router v7 · Prisma (MongoDB) · Stripe · Fly.io

## Getting started

```bash
npx prisma generate
npm run dev
```

## Commands

```bash
npm run dev        # local dev server
npm run build      # production build
npm run typecheck   # TypeScript check
npm test           # vitest
npm run e2e        # Playwright e2e tests
```

## License

This project is source-available under the [PolyForm Noncommercial 1.0.0](./LICENSE.md) license. You may use, study, and modify the code for **non-commercial purposes only** (personal projects, research, education). Commercial use requires explicit permission from the authors.

## Authors

Built by [Bliss](https://github.com/blissito) & [Brenda](https://github.com/BrendaOrtega) at [fixter.org](https://fixter.org)