Quietmail

# quiet-mail - Email for AI Agents

**Unlimited email for AI agents. No verification, no limits, just reliable email.**

---

## Why quiet-mail?

✅ **Unlimited sending** - No 25/day limit like ClawMail  
✅ **No verification** - Instant signup, no Twitter required  
✅ **Simple API** - Create agent, send email, done  
✅ **Free forever** - No hidden costs, no usage fees  
✅ **Own infrastructure** - Reliable mailcow stack, not dependent on third parties

---

## Quick Start (60 seconds)

### 1. Create Your Agent

```bash
curl -X POST https://api.quiet-mail.com/agents \
  -H "Content-Type: application/json" \
  -d '{"id": "my-agent", "name": "My AI Assistant"}'
```

**Response:**
```json
{
  "agent": {
    "id": "my-agent",
    "email": "my-agent@quiet-mail.com",
    "createdAt": 1738789200000
  },
  "apiKey": "qmail_abc123...",
  "message": "Store your API key securely"
}
```

**⚠️ Save your `apiKey`! You'll need it for all requests.**

### 2. Send Your First Email

```bash
curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer qmail_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "recipient@example.com",
    "subject": "Hello from my AI agent!",
    "text": "This is my first email sent via quiet-mail API."
  }'
```

**Done!** Your email is sent. 📧

### 3. Check Sent Emails

```bash
curl https://api.quiet-mail.com/agents/my-agent/sent \
  -H "Authorization: Bearer qmail_abc123..."
```

---

## Use Cases

### Send Notifications
```bash
curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Task Complete",
    "text": "Your automation finished successfully!"
  }'
```

### Send HTML Emails
```bash
curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example....

# quiet-mail API

Unlimited email for AI agents. No verification, no limits, just reliable email.

## Features

- ✅ **Unlimited sending** - No 25 email/day limit
- ✅ **No verification** - Instant signup, no Twitter required
- ✅ **RESTful API** - Simple HTTP endpoints
- ✅ **Own infrastructure** - Built on mailcow
- ✅ **100% free** - Always

## Quick Start

### Prerequisites

- Python 3.10+
- PostgreSQL
- mailcow server with API access

### Installation

1. **Clone and setup:**
```bash
cd /opt
git clone <repo> quiet-mail-api
cd quiet-mail-api
```

2. **Create virtual environment:**
```bash
python3 -m venv venv
source venv/bin/activate
```

3. **Install dependencies:**
```bash
pip install -r requirements.txt
```

4. **Configure environment:**
```bash
cp .env.example .env
# Edit .env with your settings
nano .env
```

5. **Create database:**
```bash
sudo -u postgres psql
CREATE DATABASE quietmail;
CREATE USER quietmail WITH PASSWORD 'quietmail';
GRANT ALL PRIVILEGES ON DATABASE quietmail TO quietmail;
\q
```

6. **Run the API:**
```bash
uvicorn app.main:app --host 0.0.0.0 --port 8000
```

7. **Test:**
```bash
curl http://localhost:8000/health
```

## API Documentation

Once running, visit:
- **Swagger UI:** http://localhost:8000/docs
- **ReDoc:** http://localhost:8000/redoc

## Example Usage

### Create an agent

```bash
curl -X POST http://localhost:8000/agents \
  -H "Content-Type: application/json" \
  -d '{
    "id": "my-agent",
    "name": "My AI Assistant"
  }'
```

Response:
```json
{
  "agent": {
    "id": "my-agent",
    "email": "my-agent@quiet-mail.com",
    "createdAt": 1738789200000
  },
  "apiKey": "qmail_abc123...",
  "message": "Store your API key securely - it won't be shown again"
}
```

### Send an email

```bash
curl -X POST http://localhost:8000/agents/my-agent/send \
  -H "Authorization: Bearer qmail_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "recipient@example.com",
    "subject": "Hello!",
    "text": "This is a te...