Лабораторія коду | Уроки програмного забезпечення

У 2025 році створити власного ШІ-помічника можна буквально за 10 хвилин. У цьому посібнику ми створимо асистента, який має:

• Текстову термінальну версію
• Веб-інтерфейс (Streamlit)
• Голосовий ввід/вивід (speech-to-text + text-to-speech)
• Пам'ять розмови (conversation history)
• Можливість завантажувати та аналізувати PDF, Word, зображення
• Повністю безкоштовно протестувати (з безкоштовними API-кредитами)

1. Отримання ключа OpenAI API (2025)

• https://platform.openai.com/account/api-keys (https://platform.openai.com/account/api-keys)
• "Create new secret key" → копіюємо
• Нові користувачі отримують $18 безкоштовних кредитів (станом на кінець 2025)

2. Встановлення необхідних пакетів (2025 актуальні версії)

python -m venv ai-asistan
cd ai-asistan
Scripts\activate
pip install openai streamlit python-dotenv speechrecognition pyaudio gtts pyaudio streamlit-chat
3. Створення файлу .env
OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
4. Простий термінальний помічник (assistant.py)
# assistant.py
import os
from openai import OpenAI
from dotenv import load_dotenv
load_dotenv()
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
# Пам'ять розмов
messages = [
    {"role": "system", "content": "Ти — корисний ШІ-помічник, який розмовляє українською мовою."}
]
print("Привіт! Чим можу допомогти? (напиши 'exit' або 'quit' для виходу)")
while True:
    user_input = input("\nВи: ")
    if user_input.lower() in ["exit", "quit"]:
        print("До побачення! 👋")
        break
   
    messages.append({"role": "user", "content": user_input})
   
    response = client.chat.completions.create(
        model="gpt-4o",      # 2025 найкраща модель
        messages=messages,
        temperature=0.7,
        max_tokens=1000
    )
   
    assistant_reply = response.choices[0].message.content
    messages.append({"role": "assistant", "content": assistant_reply})
    print(f"\nПомічник: {assistant_reply}")
5. Веб-інтерфейс — Streamlit (streamlit_app.py)
Тут дуже багато коду, але він працює "з коробки". Основні функції:

• Чат з пам'яттю
• Stream-відповіді (символ за символом)
• Гарний сучасний дизайн

6. Голосовий помічник (voice_assistant.py — бонус)

• Розпізнавання голосу українською (Google Speech Recognition)
• Відповідь голосом через gTTS
• Працює на Windows / Mac / Linux

7. Завантаження та аналіз файлів (додається в Streamlit)
# Дозволяє завантажувати PDF, Word, зображення → GPT-4o аналізує
uploaded_file = st.file_uploader("Завантаж файл (PDF, Word, зображення)",
                                 type=["pdf", "docx", "png", "jpg"])
8. Вартість використання (ціни 2025)

Модель1 млн токенів вхід1 млн токенів вихід
gpt-4o $5 / ~₴200$15 / ~₴600
gpt-4o-mini $0.15 / ₴6$0.60 / ₴24

→ При 1000 повідомленнях на місяць з gpt-4o-mini ≈ 50–100 ₴

Висновок
За 10 хвилин ви отримуєте:

• Термінального ШІ-помічника
• Веб-чату
• Голосового помічника
• Аналіз документів та зображень
• Продукт, який можна продати або використовувати як власний бренд

Повний готовий код (чиста версія):
https://github.com/kullanicin/kendi-ai-asistan-2025 (https://github.com/kullanicin/kendi-ai-asistan-2025)

Демо веб-версія:
https://kendi-ai-asistan-2025.streamlit.app (https://kendi-ai-asistan-2025.streamlit.app/)