Добро пожаловать в Culturology — веб-приложение, где мы в игровой форме знакомим вас с традициями малоизвестных народов мира.
Готовьтесь к культурному взрыву мозга! Если вам казалось, что YouTube — это предел разнообразия, теперь у вас будет повод сказать:
"Я знаю племя, где танцуют с огнём под звуки носорога! А ты?"
- Хотите блеснуть знаниями на следующей вечеринке?
- Устали от скучных викторин и банальных фактов?
- Мечтаете прокачать мозги и при этом не уснуть за компьютером?
Culturology — ваш персональный гид в мир ярких культурных открытий, быстрых квизов и чат-бота, который уж точно не будет говорить «Извините, я робот…»
- Квизы — проверяйте себя: кто из ваших друзей первым угадает национальный танец народа моари?
- Справочник народов — зубрите факты про племена, которые никто не знал (а теперь узнаете вы).
- Умный поиск — находите информацию по ключевым словам или скролльте, как в любой соцсети.
- Интерактивная карта — клик по стране — культурный детокс.
- AI-чат-бот — болтайте с нашей «искусственной личностью», которая знает, как выжить на фестивале Холи или племенном сборище.
| Компонент | Технология |
|---|---|
| Backend | FastAPI + Pydantic |
| Frontend | Vite + TypeScript + Tailwind CSS |
| База данных | PostgreSQL |
| AI-чат-бот | OpenAI API |
| Деплоймент | DigitalOcean |
| Домен | NameCheap |
-
Клонируйте репозиторий:
git clone https://github.com/BEknUur/Culturology.git cd Culturology -
Создайте файл
.envв корне проекта и добавьте:VITE_CLERK_PUBLISHABLE_KEY=<ваш ключ Clerk> OPENAI_API_KEY=<ваш ключ OpenAI> DATABASE_URL=<ваша строка подключения к БД> VITE_API_URL=http://localhost:8000
-
Запуск бэкенда:
cd backend python3 -m venv venv source venv/bin/activate # для Linux/macOS venv\Scripts\activate # для Windows pip install -r requirements.txt uvicorn app.main:app --reload
-
Запуск фронтенда:
cd ../frontend npm install npm run dev -
Откройте в браузере:
http://localhost:5173
- Исследование — сбор данных и
- Итерации — поэтапные правки
- Интеграция AmCharts 5 для визуализации миграционных путей.
- Использование Clerk для безопасной авторизации и управления сессиями.
- Адаптивный UI/UX с Tailwind CSS и Framer Motion для анимаций.
- Применение OpenAI API для создания «живого» чат-бота.
- FastAPI — быстрый, простой и отлично масштабируется.
- Vite — молниеносная сборка фронтенда.
- Tailwind CSS — гибкая настройка стилей без тяжелых зависимостей.
- OpenAI API — мощь современных языковых моделей для интерактива.
- DigitalOcean — стабильный хостинг с простым управлением.