AI-заметки

Создавайте, редактируйте и удаляйте заметки. По кнопке «Сгенерировать» Groq выводит краткое резюме по мере генерации, затем добавляет три тега. Заметки и результаты хранятся в SQLite.

Запуск на Windows

Понадобятся Python 3.11+ и Node.js 22.12+ с npm.

Вариант 1. Через `start.cmd`

Распакуйте архив проекта.
Дважды щёлкните по файлу start.cmd в папке проекта. При первом запуске дождитесь установки зависимостей и сборки интерфейса.
Откройте 127.0.0.1:8000 в браузере. Оставьте окно запуска открытым, пока пользуетесь приложением.

Чтобы остановить приложение, нажмите Ctrl+C в окне запуска. Если порт 8000 занят, откройте PowerShell в папке проекта, выполните .\start.cmd --port 8001 и перейдите на 127.0.0.1:8001.

Вариант 2. Пошагово через PowerShell

Откройте PowerShell в папке проекта. Создайте .env из шаблона, если файла ещё нет.
```
if (-not (Test-Path .env)) { Copy-Item .env.example .env }
```

В том же окне установите зависимости Python и запустите FastAPI.

cd backend
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe -m uvicorn app.main:app --env-file ../.env --port 8000

Откройте второе окно PowerShell в папке проекта. Установите зависимости и запустите React.
```
cd frontend
npm.cmd ci
npm.cmd run dev
```
Откройте localhost:5173. Если Vite выбрал другой порт, используйте адрес из вывода второго терминала. Для остановки нажмите Ctrl+C в обоих окнах.

Ключ Groq

Откройте .env в корне проекта и впишите свой ключ после GROQ_API_KEY=. Если приложение уже запущено, перезапустите его, чтобы подхватить ключ. Создавать и удалять заметки можно и с пустым ключом. Получить ключ Groq

Проверка

Введите заголовок и текст, затем нажмите «Сохранить заметку».
Нажмите «Сгенерировать» и дождитесь резюме и трёх тегов. Обновите страницу, чтобы проверить сохранение.
Нажмите на заголовок или текст сохранённой заметки, внесите правку и нажмите «Сохранить изменения». После правки резюме и теги можно сгенерировать заново.
Выберите «Удалить» рядом с заметкой в боковом меню и подтвердите действие.

Если в тексте нет понятной темы, факта или задачи, приложение предложит дополнить заметку. Для короткой записи вроде «Купить молоко» резюме и теги по-прежнему доступны.

База данных создаётся в backend/data/notes.sqlite3.

Запуск на Linux и macOS

Понадобятся Python 3.11+ с модулем venv и Node.js 22.12+ с npm.

Вариант 1. Одной командой

В терминале из папки проекта выполните:

python3 start.py

Скрипт создаст .env, если его ещё нет, установит зависимости и соберёт интерфейс. Откройте 127.0.0.1:8000. Для остановки нажмите Ctrl+C.

Вариант 2. Пошагово

В терминале из папки проекта создайте .env из шаблона, если файла ещё нет.
```
test -f .env || cp .env.example .env
```

В том же терминале установите зависимости Python и запустите FastAPI.

cd backend
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python -m uvicorn app.main:app --env-file ../.env --port 8000

Во втором терминале из папки проекта запустите React.
```
cd frontend
npm ci
npm run dev
```
Откройте localhost:5173 или адрес из вывода Vite. Для остановки нажмите Ctrl+C в обоих терминалах.

Для генерации резюме настройте .env по инструкции в разделе «Ключ Groq».

5.4 KiB Raw Permalink Blame History Unescape Escape