{"id":27634720,"url":"https://github.com/one-zero-eight/hackathon-integration-platform","last_synced_at":"2026-04-09T13:51:48.513Z","repository":{"id":289502624,"uuid":"968160385","full_name":"one-zero-eight/hackathon-integration-platform","owner":"one-zero-eight","description":"AI JSON-shema builder for MTS True Tech Hack 2025","archived":false,"fork":false,"pushed_at":"2025-04-23T15:25:52.000Z","size":3314,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T16:43:42.932Z","etag":null,"topics":["ai","cicd","docker","docker-compose","fastapi","github-actions","json","json-schema","lucide-react","nextjs","pnpm","python","rag","react-query","shadcn-ui","taiwindcss","typescript"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/one-zero-eight.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-04-17T15:54:09.000Z","updated_at":"2025-04-23T15:27:48.000Z","dependencies_parsed_at":"2025-04-23T16:44:15.326Z","dependency_job_id":"0ed93a6d-a193-41eb-8718-a9f9615c1c13","html_url":"https://github.com/one-zero-eight/hackathon-integration-platform","commit_stats":null,"previous_names":["one-zero-eight/hackathon-integration-platform"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/one-zero-eight%2Fhackathon-integration-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/one-zero-eight%2Fhackathon-integration-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/one-zero-eight%2Fhackathon-integration-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/one-zero-eight%2Fhackathon-integration-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/one-zero-eight","download_url":"https://codeload.github.com/one-zero-eight/hackathon-integration-platform/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250497100,"owners_count":21440255,"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","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","cicd","docker","docker-compose","fastapi","github-actions","json","json-schema","lucide-react","nextjs","pnpm","python","rag","react-query","shadcn-ui","taiwindcss","typescript"],"created_at":"2025-04-23T19:20:45.801Z","updated_at":"2025-12-30T19:08:59.647Z","avatar_url":"https://github.com/one-zero-eight.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MTS True Tech Hack: 🧠 AI JSON Builder Platform\n\n\u003e by One-Zero-Eight\n\n[![Python][Python]][Python-url]\n[![uv][uv]][uv-url]\n[![FastAPI][FastAPI]][FastAPI-url]  \n[![Pydantic][Pydantic]][Pydantic-url]\n[![MWS GPT API][MWS-GPT-API]][MWS-GPT-API-url]  \n[![LangChain][LangChain]][LangChain-url]\n[![Ruff][Ruff]][Ruff-url]  \n[![pre-commit][pre-commit]][pre-commit-url]\n[![Docker][Docker]][Docker-url]\n[![Docker Compose][Docker-Compose]][Docker-Compose-url]\n\n[![NextJS][Nextjs]][Next-url]\n[![React][React]][react-url]\n[![React Query][react-query]][rq-url]\n[![Tailwind][Tailwind CSS]][Tailwind-url]\n[![TypeScript][TypeScript]][ts-url]\n[![ShadCN UI][Shadcnui]][shadcn-url]\n[![pnpm][pnpm]][pnpm-url]\n[![Prettier][prettier]][prettier-url]\n[![JSON][json]][json-url]\n\nДобро пожаловать! Это **интерактивная платформа на базе ИИ** для генерации структурированных JSON-схем в формате\nчат-интерфейса. Система состоит из фронтенд-приложения (Next.js) и бекенд-сервиса (FastAPI), которые работают в связке\nдля обеспечения бесшовного взаимодействия.\n\n## 🚀 Быстрый старт\n\n### 1. Клонируйте репозиторий\n\n```bash\ngit clone https://github.com/one-zero-eight/hackathon-integration-platform.git\ncd hackathon-integration-platform\n```\n\n### 2. Переменные окружения\n\n```bash\n# Скопируйте и настройте конфигурации\ncp backend/settings.example.yaml backend/settings.yaml\nnano backend/settings.yaml   # При необходимости — см. backend/settings.schema.yaml\n\ncp frontend/.env.example frontend/.env\nnano frontend/.env\n```\n\n### 3. Локальный запуск\n\n- **Frontend:**\n  ```bash\n  cd frontend\n  pnpm install\n  pnpm run dev\n  ```\n\n- **Backend:**\n  ```bash\n  cd backend\n  uv pip install -r requirements.txt\n  uvicorn main:app --reload\n  ```\n\n---\n\n## 🖼️ Демо\n\n![demo](https://imgur.com/a/json-builder-znqtCRE)\n\n---\n\n## 📦 Структура проекта\n\n```text\n├── backend/     # FastAPI + LangChain + MWS GPT API\n│   ├── settings.example.yaml  # Пример конфигурации\n│   └── ...\n├── frontend/    # Next.js + React UI\n│   ├── .env.example           # Пример переменных окружения\n│   └── ...\n└── README.md    # Вы здесь :)\n```\n\n---\n\n## 🧩 Компоненты\n\n| Название     | Описание                                         | Подробнее                                       |\n|--------------|--------------------------------------------------|-------------------------------------------------|\n| **Frontend** | Интерфейс на Next.js с Markdown и историей чатов | 📄 [`frontend/README.md`](./frontend/README.md) |\n| **Backend**  | FastAPI-сервис с REST API и LLM-обработкой       | 📄 [`backend/README.md`](./backend/README.md)   |\n\n---\n\n## 🧾 Как настроить конфигурации\n\n### 📍 backend/settings.yaml\n\nСоздайте файл `settings.yaml` на основе `settings.example.yaml`. В нем указываются ключи доступа к LLM API, параметры\nработы модели и пр.  \nПодробности в `backend/settings.schema.yaml`.\n\n### 📍 frontend/.env\n\nСоздайте `.env` на основе `.env.example` и укажите:\n\n```env\nNEXT_PUBLIC_API_BASE_URL=http://localhost:8000/api\n```\n\nЭто URL, по которому фронтенд будет обращаться к бекенду.\n\n---\n\n## 📚 Полезные ссылки\n\n- [Backend API Docs (Swagger UI)](http://localhost:8000/api/docs)\n- [Next.js Документация](https://nextjs.org/docs)\n- [LangChain](https://www.langchain.com/)\n- [MWS GPT API](https://api.gpt.mws.ru/)\n\n---\n\n## 🛠️ Для разработчиков\n\n- Используется `pnpm/npm/yarn/bun` (фронтенд) и `uv` (бекенд) для установки зависимостей.\n- Стили — через Tailwind + shadcn/ui.\n- Чат использует Markdown-рендеринг и подсветку синтаксиса.\n\n---\n\n[Python]: https://img.shields.io/badge/Python_3.12-000000?style=for-the-badge\u0026logo=python\n\n[Python-url]: https://www.python.org/downloads/\n\n[uv]: https://img.shields.io/badge/uv-000000?style=for-the-badge\u0026logo=python\n\n[uv-url]: https://github.com/astral-sh/uv\n\n[FastAPI]: https://img.shields.io/badge/FastAPI-000000?style=for-the-badge\u0026logo=fastapi\n\n[FastAPI-url]: https://fastapi.tiangolo.com/\n\n[Pydantic]: https://img.shields.io/badge/Pydantic-000000?style=for-the-badge\u0026logo=pydantic\n\n[Pydantic-url]: https://docs.pydantic.dev/latest/\n\n[MWS-GPT-API]: https://img.shields.io/badge/MWS_GPT_API-000000?style=for-the-badge\u0026logo=openai\n\n[MWS-GPT-API-url]: https://api.gpt.mws.ru/\n\n[LangChain]: https://img.shields.io/badge/LangChain-000000?style=for-the-badge\u0026logo=langchain\n\n[LangChain-url]: https://www.langchain.com/\n\n[Ruff]: https://img.shields.io/badge/Ruff-000000?style=for-the-badge\u0026logo=ruff\n\n[Ruff-url]: https://docs.astral.sh/ruff/\n\n[pre-commit]: https://img.shields.io/badge/pre--commit-000000?style=for-the-badge\u0026logo=pre-commit\n\n[pre-commit-url]: https://pre-commit.com/\n\n[Docker]: https://img.shields.io/badge/Docker-000000?style=for-the-badge\u0026logo=docker\n\n[Docker-url]: https://www.docker.com/\n\n[Docker-Compose]: https://img.shields.io/badge/Docker_Compose-000000?style=for-the-badge\u0026logo=docker\n\n[Docker-Compose-url]: https://docs.docker.com/compose/\n\n[NextJS]: https://img.shields.io/badge/Next-black?style=for-the-badge\u0026logo=next.js\u0026logoColor=white\n\n[Next-url]: https://nextjs.org/\n\n[Tailwind CSS]: https://img.shields.io/badge/tailwind-000000?style=for-the-badge\u0026logo=tailwindCSS\n\n[Tailwind-url]: https://tailwindcss.com/\n\n[pnpm]: https://img.shields.io/badge/pnpm-000000.svg?style=for-the-badge\u0026logo=pnpm\u0026logoColor=f69220\n\n[pnpm-url]: https://pnpm.io/\n\n[TypeScript]: https://img.shields.io/badge/typescript-000000.svg?style=for-the-badge\u0026logo=typescript\u0026logoColor=white\n\n[ts-url]: https://www.typescriptlang.org/\n\n[Shadcnui]: https://img.shields.io/badge/shadcn/ui-000000.svg?style=for-the-badge\u00262F\u0026logo=shadcnui\u0026color=131316\n\n[shadcn-url]: https://ui.shadcn.com/\n\n[json]: https://img.shields.io/badge/json-000000.svg?style=for-the-badge\u0026logo=json\u0026logoColor=white\n\n[json-url]: https://www.json.org/json-en.html\n\n[React]: https://img.shields.io/badge/react-000000.svg?style=for-the-badge\u0026logo=react\u0026logoColor=%2361DAFB\n\n[react-url]: https://react.dev/\n\n[react-query]: https://img.shields.io/badge/React_Query-000000.svg?style=for-the-badge\u0026logo=ReactQuery\u0026logoColor=white\n\n[rq-url]: https://tanstack.com/query/latest/docs/framework/react/overview\n\n[prettier]: https://img.shields.io/badge/prettier-000000.svg?style=for-the-badge\u0026logo=prettier\u0026logoColor=F7BA3E\n\n[prettier-url]: https://prettier.io/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fone-zero-eight%2Fhackathon-integration-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fone-zero-eight%2Fhackathon-integration-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fone-zero-eight%2Fhackathon-integration-platform/lists"}