convez.ai
PluginProdutividadeIntermediário
OleksiyM

Task API com IA

OleksiyM/task-api

Gerenciador de tarefas RESTful com descrições geradas por IA

Ver no GitHub
InicialPluginScore · de 0 a 100

API 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-api

1 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

Estrelas
1
Forks
0
Acompanhando
1
Saúde
42%
Último commit
há 1 ano
Versão
—
Issues abertas
0
Contribuidores
1

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

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)

  1. Clone the repository
  2. Set your Gemini API key in the .env file or through environment variables
    • Create a .env file with GEMINI_API_KEY=your-key-here (see .env.example)
    • This is required for the Gemini integration to work in Docker
  3. Run with Docker Compose:
docker-compose up --build

Local Development

  1. Install Go from the site
  2. Clone the repository
  3. Install dependencies:
go mod download
  1. Set environment variables:

Linux/Mac

export GEMINI_API_KEY="your-api-key-here"

Windows

set GEMINI_API_KEY=your-api-key-here
  1. Run the application:
go run main.go

Testing with the Simple GUI

For quick testing, you can use the included simple-gui.html file:

  1. Start the Task API using either Docker or local development method
  2. Open the simple-gui.html file in any web browser
  3. The GUI will allow you to perform all operations (create, read, update, delete tasks)
  4. No installation is needed - simply open the HTML file from any local location

API Endpoints

MethodEndpointDescription
GET/tasksGet all tasks
GET/tasks/:idGet a specific task
POST/tasksCreate a task with Claude AI description
POST/tasks/ollamaCreate a task with Ollama AI description
POST/tasks/geminiCreate a task with Gemini AI description
PUT/tasks/:idUpdate a task
DELETE/tasks/:idDelete 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_KEY with a valid API key
  • The database is stored in tasks.db in the application directory
  • CORS is enabled for all origins for easier frontend integration

License

This project is licensed under the MIT License.

Ver o original no GitHub

Bom para

Relacionados