README.md

---
title: Todo List Backend API
emoji: ⚡
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---

# Todo List Backend API

FastAPI-based REST API for managing tasks with PostgreSQL persistence, AI chatbot, and WebSocket support.

## Features

- ✅ Full CRUD operations for tasks
- ✅ User authentication with JWT
- ✅ AI chatbot for task management (OpenAI & Google Gemini)
- ✅ WebSocket real-time events
- ✅ Task tags, due dates, and priorities
- ✅ Conversation history
- ✅ MCP server integration
- ✅ OpenAPI documentation

## Tech Stack

- Python 3.13+
- FastAPI (web framework)
- SQLModel (ORM)
- Neon PostgreSQL (database)
- OpenAI & Google Gemini (AI)
- WebSockets (real-time events)

## API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/api/auth/sign-up` | Register user |
| POST | `/api/auth/sign-in` | Login user |
| GET | `/api/tasks` | List tasks |
| POST | `/api/tasks` | Create task |
| GET | `/api/tasks/{id}` | Get task details |
| PUT | `/api/tasks/{id}` | Update task |
| DELETE | `/api/tasks/{id}` | Delete task |
| POST | `/api/chat` | AI chat endpoint |
| WS | `/ws` | WebSocket events |

## API Documentation

Once deployed, access interactive docs at `/docs`

## Environment Variables

Required variables are configured in the Space settings.

## License

MIT