{"id":30180892,"url":"https://github.com/nuriadevs/ai-chat-system","last_synced_at":"2026-05-07T01:08:13.307Z","repository":{"id":305893720,"uuid":"1024295882","full_name":"nuriadevs/ai-chat-system","owner":"nuriadevs","description":"A complete full-stack chat application with artificial intelligence integration. This project consists of a backend with FastAPI and a frontend in React and Next.js that work together to provide an interactive chat experience with AI.","archived":false,"fork":false,"pushed_at":"2025-07-22T13:43:48.000Z","size":565,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-22T15:32:43.648Z","etag":null,"topics":["ai","chat","chatbot","chatgpt","nextsjs","openai","python"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nuriadevs.png","metadata":{"files":{"readme":"README.es.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-22T13:31:01.000Z","updated_at":"2025-07-22T13:46:26.000Z","dependencies_parsed_at":"2025-07-22T15:32:48.676Z","dependency_job_id":"8be61622-99e9-4666-b531-09938ffcb110","html_url":"https://github.com/nuriadevs/ai-chat-system","commit_stats":null,"previous_names":["nuriadevs/ai-chat-system"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/nuriadevs/ai-chat-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuriadevs%2Fai-chat-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuriadevs%2Fai-chat-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuriadevs%2Fai-chat-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuriadevs%2Fai-chat-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nuriadevs","download_url":"https://codeload.github.com/nuriadevs/ai-chat-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuriadevs%2Fai-chat-system/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270024697,"owners_count":24514054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chat","chatbot","chatgpt","nextsjs","openai","python"],"created_at":"2025-08-12T08:05:51.286Z","updated_at":"2026-05-07T01:08:08.279Z","avatar_url":"https://github.com/nuriadevs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sistema de Chat IA\n\n## 🚀 Descripción del Proyecto\nUna aplicación completa full-stack de chat con integración de inteligencia artificial. Este proyecto consiste en un backend con FastAPI y un frontend en React y Next.js que trabajan juntos para proporcionar una experiencia de chat interactiva con IA.\n\n[![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=for-the-badge\u0026logo=fastapi)](https://fastapi.tiangolo.com/) [![React](https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB)](https://reactjs.org/)\n\n [![Next.js](https://img.shields.io/badge/next.js-000000?style=for-the-badge\u0026logo=nextdotjs\u0026logoColor=white)](https://nextjs.org/)\n\n [![OpenAI API](https://img.shields.io/badge/OpenAI-4A4A55?style=for-the-badge\u0026logo=openai)](https://platform.openai.com/) [![Python](https://img.shields.io/badge/Python-3.13.3-blue?style=for-the-badge\u0026logo=python\u0026logoColor=yellow)](https://www.python.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n\n\n## Características\n\n-   **Chat IA en tiempo real**: Respuestas instantáneas del modelo de lenguaje de OpenAI.\n-   **UI**: Interfaz responsiva basada en React y Next.js.\n-   **API RESTful**: Backend con FastAPI y endpoints.\n-   **Multiplataforma**: Funciona en escritorio, tablet y dispositivos móviles\n-   **Arquitectura escalable**: Construido con la intención de que sea un proyecto escalable.\n\n## 📁 Estructura del Proyecto\n\n```\nai-chat-system/\n├── backend-chat/              # Aplicación backend con FastAPI\n│   ├── app/                   # Código de la aplicación\n│   │   ├─── api/              # Definición de rutas y controladores\n│   │   │   ├─── routes/       # Submódulos de rutas organizadas por funcionalidad\n│   │   │   │   ├─── ai/       # Rutas relacionadas con la IA\n│   │   │   │   ├─── public/   # Rutas públicas sin autenticación\n│   │   ├─── config/           # Configuración general del sistema\n│   │   ├─── constants/        # Variables constantes \n│   │   ├─── models/           # Modelos de datos \n│   │   ├─── responses/        # Estructuras de respuesta \n│   │   ├─── services/         # Lógica de negocio y servicios externos\n│   │   ├─── utils/            # Funciones auxiliares y utilitarias\n│   │   ├── main.py            # Punto de entrada de la aplicación\n│   ├── .env                   # Variables de entorno\n│   ├── tests/                 # Pruebas unitarias y de integración\n│   ├── requirements.txt       # Dependencias de Python\n│   ├── README.md              # Documentación específica del backend en inglés\n│   ├── README.es.md           # Documentación específica del backend en español\n│\n├── frontend-chat/             # Aplicación frontend con React\n│   ├── src/                   # Código fuente\n│   │   ├─── app/              # Configuración principal y enrutamiento\n│   │   ├─── components/       # Componentes reutilizables de la interfaz\n│   │   ├─── constants/        # Constantes globales de frontend \n│   │   ├─── hooks/            # Hooks \n│   │   ├─── lib/              # Librerías y utilidades auxiliares\n│   │   ├─── services/         # Funciones para interactuar con APIs\n│   │   ├─── styles/           # Estilos globales \n│   │   ├─── types/            # Definiciones de tipos y modelos TypeScript\n│   │   ├── __tests__/         # Pruebas unitarias del frontend con jest\n│   ├── package.json           # Dependencias de Node.js\n│   ├── README.md              # Documentación específica del frontend\n│   └── ...\n│   ├── README.md              # Documentación específica del backend en inglés\n│   ├── README.es.md           # Documentación específica del backend en \n└── .gitignore                 # Archivos y carpetas ignorados por Git\n\n\n```\n\n## 🛠️ Tecnologías\n\n### Backend\n\n-   **FastAPI**: Framework web de Python de alto rendimiento\n-   **OpenAI API**: Integración con modelos de lenguaje de IA\n-   **Python 3.13.3**: Runtime de Python más reciente\n-   **CORS Middleware**: Manejo de solicitudes entre dominios\n\n### Frontend\n\n-   **React**: Biblioteca de JavaScript para construir interfaces\n-  **Next.js**: Framework de React para aplicaciones web modernas.\n-   **TypeScript**: Desarrollo de JavaScript.\n-   **Tailwind**: Estilos moderno y diseño responsivo.\n\n## 🚀 Inicio Rápido\n\n### Prerrequisitos\n\n-   Python 3.13+ instalado\n-   Node.js 18+ y npm instalados\n-   Clave API de OpenAI\n\n### 1. Clonar el Repositorio\n\n```bash\ngit clone https://github.com/nuriadevs/ai-chat-system.git\ncd ai-chat-system\n```\n\n### 2. Configuración del Backend\n\n```bash\ncd backend-chat\npip install -r requirements.txt\n\n# Crear archivo .env con tu clave API de OpenAI\nOPENAI_API_KEY=\"tu_clave_api_openai_aqui\"\n\n# Iniciar el servidor backend\nuvicorn app.main:app --reload --port 8000\n\n```\n\nEl backend estará ejecutándose en `http://localhost:8000`\n\n### 3. Configuración del Frontend\n\n```bash\ncd frontend-chat\nnpm install\n\n# Iniciar el servidor de desarrollo\nnpm start\n\n```\n\nEl frontend estará ejecutándose en `http://localhost:3000`\n\n### 4. Acceder a la Aplicación\n\n¡Abre tu navegador y navega a `http://localhost:3000` para comenzar a chatear con la IA!\n\n## 📚 Documentación\n\nPara instrucciones de configuración detalladas y documentación de la API, consulta los archivos README individuales:\n\n- **Documentación Backend**: [Backend Documentation](https://github.com/nuriadevs/ai-chat-system/blob/main/backend-chat/README.es.md)\n- **Documentación Frontend**: [Frontend Documentation](https://github.com/nuriadevs/ai-chat-system/blob/main/frontend-chat/README.es.md)\n\n## 🧪 Pruebas\n\n### Pruebas del Backend\n\n```bash\ncd backend-chat\npytest\n```\n\n### Pruebas del Frontend\n\n```bash\ncd frontend-chat\nnpm test\n```\n\n## 🌐 Endpoints de la API\n\n-   `GET /`: Endpoint de verificación de salud\n-   `POST /chat`: Enviar mensajes a la IA y recibir respuestas\n\nPara la documentación completa de la API, visita `http://localhost:8000/docs` cuando el backend esté ejecutándose.\n\n## 📱 Capturas de pantalla\n\n  \n\n### Escritorio\n\n  \n\n\u003cimg  src=\"images/desktop-view.png\"  alt=\"Desktop View\"  style=\"width: 400px;\"  /\u003e\n\n  \n  \n\n### Tablet\n\n  \n\n\u003cimg  src=\"images/tablet-view.png\"  alt=\"Tablet View\"  style=\"width: 300px;\"  /\u003e\n\n  \n\n### Móvil\n\n  \n\n\u003cimg src=\"images/mobile-view.png\"  alt=\"Mobile View\" style=\"width: 200px;\"/\u003e\n\n\n## 🤝 Contribuir\n\n1.  Haz fork del repositorio\n2.  Crea una rama de características (`git checkout -b feature/category-new`)\n3.  Confirma tus cambios (`git commit -m 'Agregar alguna característica nueva'`)\n4.  Empuja a la rama (`git push origin feature/category-new`)\n5.  Abre un Pull Request\n\n\n## 🔗 Enlaces\n\n- [OpenAI](https://platform.openai.com/docs/overview)\n\n- [OpenAI-Python](https://github.com/openai/openai-python)\n\n- [FastApi](https://fastapi.tiangolo.com/)\n- [Next.js](https://nextjs.org/)\n- [Tailwind](https://tailwindcss.com/)\n- [Shadcn](https://ui.shadcn.com/docs/dark-mode/next)\n\n\n\n## 📬 Contacto\n\nSi tienes alguna pregunta, sugerencia o propuesta de colaboración, no dudes en contactarme a través de mis redes sociales.\n\n### ¡Gracias por visitar este repositorio y darle una estrella! 🚀","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuriadevs%2Fai-chat-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnuriadevs%2Fai-chat-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuriadevs%2Fai-chat-system/lists"}