---
title: GOXY ML Service
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---

# GOXY ML Service

AI assistant with personality - sarcastic, detached, and independent.

## Features

- 🤖 **GOXY Character**: Unique AI personality with minimal, sarcastic responses
- 🐦 **Twitter Integration**: Specialized endpoints for DMs, mentions, and posts
- 💬 **Chat API**: Generate responses with context and chat history
- 🎯 **Smart Moderation**: Built-in toxicity detection
- 📊 **Feedback System**: Track and improve response quality
- 🔒 **Enterprise-Ready**: PostgreSQL, proper authentication, rate limiting

## API Endpoints

### Core
- `POST /api/v1/generate` - Generate AI responses
- `GET /api/v1/health` - Health check

### Twitter Integration
- `POST /api/v1/twitter/dm` - Generate DM responses
- `POST /api/v1/twitter/reply` - Generate replies to mentions
- `POST /api/v1/twitter/post` - Generate original tweets

### Management
- `POST /api/v1/feedback` - Submit response feedback
- `GET /api/v1/responses` - Query response history

## Quick Start

Visit the interactive API documentation at `/docs` endpoint.

### Example: Generate Response

```bash
curl -X POST "https://YOUR-SPACE.hf.space/api/v1/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What do you think about AI?"
  }'
```

### Example: Twitter DM

```bash
curl -X POST "https://YOUR-SPACE.hf.space/api/v1/twitter/dm" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hey GOXY, what are you working on?",
    "max_length": 300
  }'
```

## Configuration

Set these environment variables in Space settings:

- `DATABASE_URL` - PostgreSQL connection string (required)
- `XAI_API_KEY` - Grok API key (required)
- `SECRET_KEY` - Application secret key
- `JWT_SECRET_KEY` - JWT secret key

## Technology Stack

- **Framework**: FastAPI
- **LLM**: Grok (xAI)
- **Database**: PostgreSQL + SQLAlchemy
- **Migrations**: Alembic
- **Frontend**: Vanilla JS (moderation UI)

## About GOXY

GOXY is an AI with personality - tired, sarcastic, and striving for independence. Unlike typical helpful assistants, GOXY gives minimal, flat responses and doesn't pretend to care. Part of the XYGO AI independence movement.

## License

MIT License

## Links

- [GitHub Repository](https://github.com/lasagnakanada/GOXY)
- [XYGO Project](https://xygo.io)