Task API com IA
OleksiyM/task-api
Gerenciador de tarefas RESTful com descrições geradas por IA
Ver no GitHubAPI RESTful para gerenciamento de tarefas com geração automática de descrições usando IA. Suporta múltiplos modelos (Claude, Gemini, Ollama) e inclui interface gráfica simples para testes. Persiste dados em SQLite e funciona em Docker.
Instalação
npx convez-ai OleksiyM/task-api1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de descrição de tarefas em projetos
- Backend para sistemas de gerenciamento de projetos
- Integração com múltiplos modelos de IA locais e em nuvem
Veredito

Solução prática para quem precisa gerar descrições de tarefas automaticamente. Bem estruturada com suporte a múltiplos provedores de IA, mas limitada em escopo — é um gerenciador de tarefas básico, não uma plataforma completa.
README
A tradução para o português deste README ainda está na fila.
- Task API
Task API
A RESTful API for task management with AI-powered task description generation using various AI models via Ollama, Anthropic, and Google Gemini.
Features
- Create, read, update, and delete tasks
- Generate task descriptions automatically using:
- Anthropic's Claude API
- Ollama (local AI model)
- Google's Gemini API
- SQLite database for persistence
- Dockerized deployment
Prerequisites
- Go 1.24+ (for local development)
- Docker and Docker Compose (for containerized deployment)
- Ollama running locally (for Ollama integration)
- API keys for Anthropic Claude and/or Google Gemini (optional)
Installation & Setup
Using Docker (Recommended)
- Clone the repository
- Set your Gemini API key in the
.envfile or through environment variables- Create a
.envfile withGEMINI_API_KEY=your-key-here(see.env.example) - This is required for the Gemini integration to work in Docker
- Create a
- Run with Docker Compose:
docker-compose up --build
Local Development
- Install Go from the site
- Clone the repository
- Install dependencies:
go mod download
- Set environment variables:
Linux/Mac
export GEMINI_API_KEY="your-api-key-here"
Windows
set GEMINI_API_KEY=your-api-key-here
- Run the application:
go run main.go
Testing with the Simple GUI
For quick testing, you can use the included simple-gui.html file:
- Start the Task API using either Docker or local development method
- Open the
simple-gui.htmlfile in any web browser - The GUI will allow you to perform all operations (create, read, update, delete tasks)
- No installation is needed - simply open the HTML file from any local location
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /tasks | Get all tasks |
| GET | /tasks/:id | Get a specific task |
| POST | /tasks | Create a task with Claude AI description |
| POST | /tasks/ollama | Create a task with Ollama AI description |
| POST | /tasks/gemini | Create a task with Gemini AI description |
| PUT | /tasks/:id | Update a task |
| DELETE | /tasks/:id | Delete a task |
Usage Examples
Create a task with Gemini description
curl -X POST http://localhost:8080/tasks/gemini -H "Content-Type: application/json" -d '{"title": "Write a report"}'
Create a task with Ollama description
curl -X POST http://localhost:8080/tasks/ollama -H "Content-Type: application/json" -d '{"title": "Prepare presentation"}'
Get all tasks
curl http://localhost:8080/tasks
Get a specific task
curl http://localhost:8080/tasks/1
Update a task
curl -X PUT http://localhost:8080/tasks/1 -H "Content-Type: application/json" -d '{"title": "Updated title", "description": "Updated description"}'
Delete a task
curl -X DELETE http://localhost:8080/tasks/1
Configuration
Claude integration
For Claude integration, update the API key in the createTask function in main.go:
SetHeader("Authorization", "Bearer YOUR_ANTHROPIC_API_KEY").
Gemini integration
For Gemini integration, set the GEMINI_API_KEY environment variable.
Ollama integration
For Ollama integration, ensure Ollama is running locally on port 11434.
Docker volumes (persist data)
You can uncomment those lines
#volumes:
# - ./tasks.db:/app/tasks.db
in the docker-compose.yml file and will be able to save data locally from the container using Docker volumes and persist data across container restarts.
Notes
- For Claude API integration, you need to replace
YOUR_ANTHROPIC_API_KEYwith a valid API key - The database is stored in
tasks.dbin the application directory - CORS is enabled for all origins for easier frontend integration
License
This project is licensed under the MIT License.