Skip to content

byigitt/guvercin

Repository files navigation

Güvercin

AI destekli sosyal medya içerik yönetim platformu


GUvercinExplainer.mp4

React Hono PostgreSQL Bun Swift OpenAI


Nedir?

Güvercin, markanızı anlayan ve sizin yerinize içerik üreten bir AI asistanıdır. Sosyal medya hesaplarınızı tek bir platformdan yönetir, AI ile görsel/video/metin içerikler oluşturur ve bunları zamanlanmış şekilde yayınlar.

Temel fikir: Markanızın ses tonunu, değerlerini ve hedef kitlesini AI'ya bir kez öğretin. Güvercin bundan sonra her içeriği markanızın DNA'sına uygun üretsin.

Özellikler

Özellik Açıklama
Brand Brain Markanızın ses tonunu, değerlerini ve hedef kitlesini AI'ya öğretin. Her içerik, markanızın DNA'sını taşısın.
AI İçerik Üretimi Blog yazıları, sosyal medya postları, reklam metinleri, e-postalar. Saniyeler içinde profesyonel içerikler.
Görsel & Video Üretimi AI destekli görsel ve video içerik oluşturma. FAL AI ve OpenAI entegrasyonu.
Multi-Platform Instagram, Facebook, LinkedIn. Tüm platformlara özel formatlanmış içerikler tek tıkla.
Zamanlama İçeriklerinizi ileriye dönük planlayıp otomatik yayınlayın. Takvim görünümü ile kolay yönetim.
Analitik Hangi içerikler daha iyi performans gösteriyor? Yorum analizi ve duygu analizi ile strateji optimizasyonu.
iOS Uygulama SwiftUI ile native iOS uygulaması. Mobil'den içerik oluşturma ve yönetim.

Nasıl Çalışır?

1. Markanızı Tanıtın     Organizasyon ve marka oluşturun. Ses tonu, hedef kitle,
                          anahtar kelimeler ve kaçınılacak ifadeleri belirleyin.

2. AI ile Üretin          Görsel, video veya metin. Ne istediğinizi söyleyin,
                          Güvercin markanızın diliyle içeriği üretsin.

3. Yayınlayın             Instagram, Facebook ve LinkedIn hesaplarınıza gönderin
                          veya planlayın. Analitiklerle performansı takip edin.

Teknik Yapı

Proje, Bun workspace'leri kullanan bir monorepo olarak yapılandırılmıştır:

guvercin/
├── apps/
│   ├── api/           # REST API — Hono, Drizzle ORM, PostgreSQL
│   ├── client/        # Web — React 19, Vite, React Router 7
│   ├── video/         # Tanıtım videosu — Remotion 4
│   └── swift/         # iOS — SwiftUI, MVVM
└── packages/
    └── llm/           # Paylaşılan LLM yardımcı kütüphanesi

Tech Stack

Frontend: React 19 · TypeScript · Vite 7 · React Router 7 · Framer Motion · CSS Modules

Backend: Hono · TypeScript · PostgreSQL · Drizzle ORM · Better Auth · Zod · OpenAI SDK · FAL AI · AWS S3

Mobil: Swift · SwiftUI · MVVM

Video: Remotion 4 (React tabanlı programatik video üretimi)

Kurulum

Gereksinimler

Başlangıç

# Repoyu klonlayın
git clone https://github.com/byigitt/guvercin
cd guvercin

# Bağımlılıkları yükleyin
bun install

# Environment değişkenlerini ayarlayın
cp apps/api/.env.example apps/api/.env
# .env dosyasını düzenleyin (DB, OpenAI key, S3, OAuth credentials)

# Veritabanını hazırlayın
bun run --filter @btk/api db:push

# Geliştirme sunucularını başlatın
bun run dev

Komutlar

bun run dev              # Tüm uygulamaları çalıştır
bun run build            # Tüm uygulamaları derle

# API
bun run --filter @btk/api dev          # Sadece API
bun run --filter @btk/api db:studio    # Drizzle Studio (DB arayüzü)
bun run --filter @btk/api db:generate  # Migration oluştur
bun run --filter @btk/api db:migrate   # Migration uygula

# Client
bun run --filter @btk/client dev       # Sadece frontend
bun run --filter @btk/client build     # Production build

API Yapısı

Endpoint Açıklama
/organizations Organizasyon CRUD ve üyelik yönetimi
/brands Marka yönetimi ve Brand Brain metadata
/social/oauth Instagram, Facebook, LinkedIn OAuth akışları
/social/accounts Bağlı sosyal medya hesapları
/social/posts Platform postlarını çekme ve senkronizasyon
/social/comments Yorum yönetimi ve duygu analizi
/social/publish Platformlara içerik yayınlama
/content İçerik yönetimi (taslak, yayınlanmış, arşiv)
/ai/text AI metin üretimi
/ai/image AI görsel üretimi
/ai/video AI video klip üretimi
/scheduling Zamanlama ve otomasyon
/upload S3 dosya yükleme

API dokümantasyonu Scalar UI üzerinden /reference endpoint'inde erişilebilir.

Lisans

Bu proje BTK Hackathon 2026 için geliştirilmiştir.


BTK Hackathon 2026

About

🕊️ AI destekli sosyal medya içerik yönetim platformu. Markanızın ses tonunu öğrenen AI ile görsel, video ve metin içerikler üretin, zamanlayın ve yayınlayın.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors