README.md

metadata

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