comunidad bovedaauto-crm

Auto-CRM

Tu propio sistema para manejar clientes y ventas. Corre en tu computadora, se adapta a tu negocio con Claude Code, y es 100% gratis. Sin Salesforce, sin HubSpot, sin pagar mensualidad.

Proyecto open source de la comunidad

El codigo completo de Auto-CRM esta disponible en GitHub. Descargalo, usalo y personalizalo.

Danos una estrella en GitHub para apoyar el proyecto.

Descargar ZIP Ver en GitHub

antes de empezar

Que necesitas tener instalado

Solo necesitas 2 cosas

Antes de descargar Auto-CRM, asegurate de tener estas dos herramientas. Si ya las tienes, puedes saltar directamente a la instalacion.

Node.js (version 20 o superior)

Node.js es el motor que hace que Auto-CRM funcione. Si no lo tienes, descargalo gratis desde nodejs.org. Cuando lo instales, escoge la version LTS (la que dice "Recommended").

Como verificar si ya lo tienes

node --version

Si ves un numero como v20.x.x o v22.x.x, ya lo tienes. Si dice "command not found", necesitas instalarlo.

Claude Code

Claude Code es el asistente de IA que vive en tu terminal. Es lo que hace que Auto-CRM sea especial — te ayuda a personalizar todo con solo pedirlo en espanol. Si no lo tienes instalado, corre este comando:

Como verificar si ya lo tienes

claude --version

Si ves un numero de version, ya lo tienes. Si no, sigue la guia de instalacion en la boveda.

Que es la terminal?

La terminal es una pantalla donde escribes comandos para hablar con tu computadora. No te preocupes si nunca la has usado — solo vas a copiar y pegar lo que te digamos aqui.

En Mac

Busca "Terminal" en Spotlight (Cmd + Espacio) o abrela desde Aplicaciones > Utilidades > Terminal.

En Windows

Busca "PowerShell" o "CMD" en el menu de inicio. Recomendamos PowerShell para mejor compatibilidad.

instalacion

Como instalar Auto-CRM paso a paso

Sigue estos 6 pasos y tendras tu CRM corriendo en minutos

Descarga el proyecto

Ve a la pagina de Auto-CRM en GitHub. Busca el boton verde que dice "Code" y dale click. En el menu que se abre, selecciona "Download ZIP". Es exactamente como descargar cualquier archivo de internet — se va a guardar en tu carpeta de Descargas.

Tambien puedes usar el boton de "Descargar ZIP" que esta arriba en esta misma pagina, o este link directo:

Descargar ZIP directo

Descomprime la carpeta

Busca el archivo que se llama "auto-crm-main.zip" en tu carpeta de Descargas. Dale doble click y se va a descomprimir automaticamente. En Mac se crea una carpeta al lado del ZIP. En Windows dale click derecho y selecciona "Extraer todo". Adentro vas a ver una carpeta llamada "auto-crm-main" con todos los archivos del proyecto.

Abre tu terminal en la carpeta del proyecto

Abre tu terminal y navega hasta la carpeta que acabas de descomprimir. El comando "cd" significa "cambiar directorio" — le dice a la terminal que entre a esa carpeta. Si la descargaste en otra ubicacion, cambia la ruta.

En Mac tambien puedes arrastrar la carpeta al icono de Terminal para abrirla directamente ahi.

cd ~/Downloads/auto-crm-main

Abre Claude Code dentro del proyecto

Con este comando abres Claude Code. Es importante que lo abras dentro de la carpeta del proyecto para que Claude pueda ver todos los archivos y ayudarte. Cuando se abra, vas a ver que Claude te saluda y esta listo para recibir instrucciones.

Si Claude Code te pide permisos para leer archivos, dale que si. Necesita ver el proyecto para poder ayudarte.

claude

Instala las dependencias del proyecto

Este comando descarga todas las piezas que Auto-CRM necesita para funcionar — la base de datos, los componentes visuales, las graficas, etc. Puede tardar 1-2 minutos dependiendo de tu internet. Vas a ver muchas lineas de texto corriendo — es normal, solo espera a que termine.

Puedes correr este comando directamente en tu terminal o pedirle a Claude que lo haga por ti.

npm install

Arranca tu CRM

Este es el momento de la verdad. Este comando prende el servidor de Auto-CRM en tu computadora. Cuando veas el mensaje que dice "Ready" o "started server on localhost:3000", significa que ya esta corriendo. No cierres la terminal — si la cierras, el CRM se apaga.

npm run dev

Abre tu navegador en http://localhost:3000 y listo!

Escribe esa direccion en la barra de tu navegador (Chrome, Safari, Firefox — cualquiera sirve). Vas a ver el dashboard de Auto-CRM con todas las secciones listas para usar.

Atajo para desarrolladores (si ya tienes git)

Si ya manejas la terminal y tienes git instalado, puedes hacer toda la instalacion con una sola linea. Esto clona el repositorio, entra a la carpeta, instala dependencias y arranca el servidor:

git clone https://github.com/Hainrixz/auto-crm.git && cd auto-crm && npm install && npm run dev

Quieres ver datos de ejemplo?

Auto-CRM empieza vacio — como una libreta nueva. Si quieres ver como se ve con contactos, deals y actividades de ejemplo para entender como funciona, corre este comando. Los datos de ejemplo se pueden borrar despues sin problema:

npm run init:seed

Modo produccion (para uso diario)

Si quieres usar Auto-CRM todos los dias (no solo para probar), usa el modo produccion. Es mas rapido y estable. Solo cambia el ultimo comando:

npm run local

01 el proyecto

Que es Auto-CRM?

Auto-CRM es un sistema completo para manejar tus clientes, ventas y seguimientos. Piensa en el como una libreta super inteligente que vive en tu computadora — pero en vez de escribir a mano, le hablas a Claude Code en espanol y el hace todo por ti.

Puedes agregar contactos, mover deals entre etapas de venta con drag and drop, mandar WhatsApp con un click, recibir leads automaticos desde tus formularios web, ver graficas de tu pipeline, clasificar leads con inteligencia artificial, y recibir un resumen diario por email. Todo gratis, todo local, todo tuyo.

100% Local

Todo vive en tu computadora. La base de datos es un archivo SQLite que se guarda en la carpeta del proyecto. Tus datos de clientes nunca salen de tu maquina — nadie los ve, nadie los vende, nadie los usa para entrenar IA.

Se personaliza solo

Dile a Claude Code como funciona tu negocio y el adapta el CRM para ti. Cambia las etapas de venta, agrega campos nuevos, modifica el idioma, el tema visual — todo sin tocar codigo. Solo pidelo en espanol.

Gratis para siempre

Es open source bajo licencia libre. No pagas mensualidad, no hay limite de contactos, no hay version "premium" escondida. El codigo es tuyo y puedes modificarlo como quieras.

Para quien es Auto-CRM

Freelancers y consultores

Lleva el control de tus clientes, propuestas y seguimientos sin pagar Salesforce.

Equipos de ventas pequenos

Pipeline visual con kanban, clasificacion de leads y alertas de seguimiento.

Negocios locales

Registra clientes, manda WhatsApp con un click y recibe leads de tus formularios.

No necesitas saber programar

Auto-CRM fue disenado para que cualquier persona lo use. Claude Code hace todo el trabajo tecnico por ti — instala dependencias, configura la base de datos, y personaliza el sistema. Tu solo le dices que quieres en espanol y el lo hace. Si algo falla, le dices "arreglalo" y el lo intenta de nuevo.

Tech stack (para desarrolladores)

Si eres desarrollador y quieres entender que hay bajo el capo, o contribuir al proyecto:

Next.js 16

Framework web de React para el frontend y backend

React 19

La libreria de UI mas popular del mundo

TypeScript

JavaScript con tipos para codigo mas seguro

Tailwind CSS v4

Framework de estilos para el diseno visual

SQLite + Drizzle

Base de datos local — no necesitas instalar nada

shadcn/ui

Componentes de UI accesibles y modernos

Recharts

Graficas y visualizaciones del dashboard

@dnd-kit

Drag and drop para el tablero kanban

02 funciones

Todo lo que puede hacer

Auto-CRM viene con todo lo que necesitas para manejar clientes y ventas desde el dia uno. Cada funcion esta disenada para ser simple de usar pero potente por dentro.

Dashboard con KPIs

La pantalla principal te muestra todo de un vistazo: cuantos contactos tienes, deals activos, valor total del pipeline, leads calientes y graficas de rendimiento. Es como el tablero de tu carro pero para tu negocio.

Se actualiza en tiempo real cada vez que agregas o mueves algo.

Pipeline Kanban

Un tablero visual donde ves todos tus deals organizados por etapa. Arrastra y suelta un deal de una columna a otra conforme avanza la venta — de "Nuevo" a "En negociacion" a "Cerrado". Como mover post-its en un tablero.

Las etapas son personalizables con el comando /setup.

Contactos con lead scoring

Una tabla con todos tus contactos que puedes buscar, filtrar por temperatura (frio, tibio, caliente) y editar. Cada contacto tiene un score del 0 al 100 que te dice que tan listo esta para comprar.

El score se calcula automaticamente con reglas o con IA si tienes la API key.

WhatsApp y llamadas rapidas

Cada contacto tiene botones de accion directa: mandar WhatsApp, hacer llamada telefonica o copiar el numero. Un solo click y se abre la app correspondiente. Sin salir del CRM, sin buscar numeros.

Funciona en desktop y movil — en movil abre la app de WhatsApp directamente.

Historial de actividades

Registra cada interaccion con un cliente: notas, llamadas, emails, reuniones. Ve la linea del tiempo completa de cada contacto. El sistema te alerta cuando un seguimiento esta atrasado para que no se te pase.

Las alertas de seguimiento aparecen en el dashboard y en el email digest.

Clasificacion inteligente de leads

El sistema puntua tus leads automaticamente usando reglas basadas en sus datos (fuente, actividad, tiempo sin contacto). Si agregas tu API key de Anthropic, Claude analiza cada lead y da una clasificacion mas precisa con explicacion.

Sin API key usa reglas basicas que funcionan bien. Con API key, la IA le da contexto humano.

Webhooks automaticos

Conecta tus formularios de captura de leads y los contactos entran solos al CRM. Compatible con Typeform, Tally, Google Forms y Zapier. Configuras la URL del webhook una vez y listo — cada formulario nuevo crea un contacto automaticamente.

La URL del webhook la encuentras en la configuracion del proyecto.

Importar y exportar CSV

Sube tus contactos desde un archivo de Excel o CSV para migrar tus datos existentes. Tambien puedes descargar todos tus contactos y deals para usarlos en otro programa, hacer reportes o tener un respaldo.

Usa el comando /import-csv en Claude Code para una importacion guiada.

Resumen diario por email

Recibe un correo automatico cada dia con un resumen de todo lo que paso: leads nuevos, deals que avanzaron, seguimientos pendientes y metricas clave. Como tener un asistente que te prepara un reporte cada manana.

Necesita las variables RESEND_API_KEY y DIGEST_EMAIL configuradas.

Servidor MCP con 10 herramientas

Conecta Auto-CRM con Claude Desktop o Claude Web usando el protocolo MCP. Claude puede leer tus contactos, buscar deals, ver metricas y mas — directamente desde la conversacion, sin que copies y pegues nada.

Configurable en claude_desktop_config.json — instrucciones en la seccion de comandos.

8 comandos de Claude Code

Comandos listos para usar dentro de Claude Code: configurar el CRM, agregar contactos, buscar informacion, ver metricas del pipeline, gestionar seguimientos, importar datos, clasificar leads y enviar el digest.

Escribe / en Claude Code para ver la lista completa de comandos disponibles.

Docker incluido

Si quieres correr Auto-CRM en un servidor o en la nube, el proyecto ya viene con Docker Compose configurado. Un solo comando y tienes el CRM corriendo en un contenedor con los datos persistidos.

Los datos se guardan en ./data/ y sobreviven reinicios del contenedor.

03 comandos

Comandos y herramientas incluidas

8 Comandos de Claude Code

Estos comandos ya vienen listos para usar. Solo abre Claude Code dentro del proyecto y escribe cualquiera de ellos. Cada uno te guia paso a paso — no necesitas memorizar nada, Claude te pide lo que necesita.

/setupConfigura todo tu CRM desde cero

Te guia paso a paso para definir tus etapas de venta, fuentes de leads, idioma de la interfaz y tema visual. Es lo primero que deberias correr despues de instalar.

/add-contactAgrega un contacto nuevo

Claude te pide nombre, email, telefono y los datos que necesites. El contacto queda guardado en la base de datos al instante.

/searchBusca contactos o deals

Busca por nombre, email o cualquier dato. Te muestra los resultados con toda su informacion y puedes actuar sobre ellos.

/metricsVe las metricas del pipeline

Muestra un resumen de cuantos deals tienes por etapa, valor total, tasa de conversion y leads activos. Ideal para hacer revisiones rapidas.

/follow-upsVe seguimientos pendientes

Lista todos los contactos que necesitan seguimiento, ordenados por urgencia. Te dice cuanto tiempo llevan sin contacto.

/import-csvImporta contactos desde CSV/Excel

Te guia para subir un archivo CSV con tus contactos existentes. Mapea las columnas automaticamente y valida los datos antes de importar.

/classifyClasifica leads con IA

Analiza todos tus leads y les asigna un score y temperatura usando inteligencia artificial. Necesita la variable ANTHROPIC_API_KEY configurada.

/digestEnvia el resumen diario por email

Genera y envia un email con el resumen del dia: leads nuevos, deals movidos, seguimientos atrasados y metricas clave. Necesita RESEND_API_KEY.

Primer comando que deberias correr

Despues de instalar Auto-CRM, abre Claude Code y corre /setup. Este comando te guia para personalizar tu CRM: nombre del negocio, etapas de venta, fuentes de leads, idioma y colores. Solo toma unos minutos.

/setup

10 Herramientas MCP

Si usas Claude Desktop o Claude Web, puedes conectar Auto-CRM como servidor MCP. Esto le da a Claude acceso directo a los datos de tu CRM desde cualquier conversacion, sin que tu abras la terminal ni copies y pegues nada.

list_contacts

Lista todos los contactos del CRM

search_contacts

Busca contactos por nombre, email o telefono

get_contact

Ve los detalles completos de un contacto

list_deals

Lista todos los deals del pipeline

get_deal

Ve los detalles de un deal especifico

get_pipeline_metrics

Metricas del pipeline de ventas

list_activities

Historial de actividades de un contacto

get_follow_ups

Seguimientos pendientes y atrasados

classify_leads

Clasifica leads con reglas o IA

get_dashboard_summary

Resumen completo del dashboard

Que es MCP y como lo conecto?

MCP (Model Context Protocol) es una forma de conectar Claude con programas externos. Piensa en el como un cable que conecta tu CRM directamente con Claude para que pueda leer y manejar tus contactos y deals sin que tu hagas nada manualmente.

Para conectarlo a Claude Desktop, agrega la configuracion del servidor MCP en tu archivo de configuracion. Auto-CRM incluye el servidor listo — solo necesitas apuntar Claude Desktop a la ruta del proyecto.

04 configuracion

Configuracion opcional

Auto-CRM funciona perfecto sin configurar nada extra

Todo lo de abajo es 100% opcional. El dashboard, kanban, contactos, actividades, webhooks y comandos de Claude Code funcionan sin ninguna variable de entorno. Solo configura estas opciones si quieres las funciones avanzadas.

Como agregar variables de entorno

Las variables de entorno son como "configuraciones secretas" que le dicen al programa tus keys y preferencias. Para agregarlas, crea un archivo llamado .env en la carpeta principal del proyecto (donde esta el archivo package.json).

Puedes crearlo manualmente o pedirle a Claude Code que lo haga por ti:

echo "ANTHROPIC_API_KEY=tu-key-aqui" > .env

Cada variable va en su propia linea, con el formato NOMBRE=valor (sin espacios alrededor del =). El archivo .env nunca se sube a GitHub — tus keys siempre se quedan en tu computadora.

ANTHROPIC_API_KEYOpcional

Activa la clasificacion de leads con IA.

Sin esta key, Auto-CRM clasifica leads usando reglas basicas (que funcionan bien). Con ella, Claude analiza cada lead y te da una clasificacion con contexto humano. Consigue tu key en console.anthropic.com.

RESEND_API_KEYOpcional

Activa el resumen diario por email.

Resend es un servicio de email gratuito (hasta 3,000 emails/mes gratis). Crea tu cuenta en resend.com, genera una API key y pegala aqui.

DIGEST_EMAILOpcional

A donde llega el resumen diario.

El correo electronico donde quieres recibir el resumen. Puede ser cualquier email — Gmail, Outlook, tu dominio propio.

DIGEST_FROMOpcional

Quien aparece como remitente.

El nombre y email que aparece como remitente del resumen. Ejemplo: Auto-CRM <onboarding@resend.dev>. Si usas tu propio dominio en Resend, puedes personalizarlo.

3 modos de inteligencia artificial

Auto-CRM tiene 3 formas de usar IA, dependiendo de tu setup:

Terminal (default)

Claude Code maneja la IA directamente desde tu terminal. No necesitas API key.

API

Con ANTHROPIC_API_KEY, el CRM llama a Claude directamente para clasificar leads.

MCP

Conecta el CRM a Claude Desktop/Web para manejar datos desde la conversacion.

Correr con Docker (avanzado)

Si prefieres usar Docker para aislar el proyecto o correrlo en un servidor, Auto-CRM ya viene con un archivo docker-compose.yml configurado. Tus datos se guardan en la carpeta ./data/ y persisten aunque reinicies el contenedor.

Iniciar con Docker

docker compose up -d

Detener

docker compose down

Necesitas Docker Desktop instalado. Descargalo gratis en docker.com.

Proyecto de la comunidad

Auto-CRM es un proyecto open source creado por @Hainrixz para la comunidad de Tododeia. Es 100% gratuito, modificable y tuyo para siempre.

Codigo fuente

Ver en GitHub

Reportar problemas

Abre un issue en GitHub

Descargar ZIP

Ultima version del proyecto

Necesitas ayuda?

Si algo no funciona o tienes dudas, abre un issue en GitHub describiendo tu problema. Tambien puedes abrir Claude Code dentro del proyecto y decirle "algo no funciona" — en la mayoria de los casos el puede diagnosticar y arreglar el problema por ti.