Skip to content

Latest commit

 

History

History
269 lines (186 loc) · 4.66 KB

QUICKSTART.md

File metadata and controls

269 lines (186 loc) · 4.66 KB

AgentArmy - Quick Start Guide

Pääset alkuun 5 minuutissa! 🚀

📋 Esivalmistelut

1. Asenna riippuvuudet

# Python 3.11+
python3 --version

# Node.js 22+
node --version

# Pip
pip3 --version

# NPM
npm --version

Jos jotain puuttuu, asenna ne:

🏃 Pika-aloitus (Lokaali kehitys)

Backend

cd backend

# Asenna riippuvuudet
pip3 install -r requirements.txt

# Luo .env-tiedosto
cp .env.example .env

# Muokkaa .env-tiedostoa (lisää API-avaimet)
nano .env

# Käynnistä backend
uvicorn main_api:app --reload

Backend pyörii nyt osoitteessa: http://localhost:8000

API-dokumentaatio: http://localhost:8000/docs

Frontend

cd frontend

# Asenna riippuvuudet
npm install

# Luo .env-tiedosto
echo "VITE_API_URL=http://localhost:8000" > .env

# Käynnistä frontend
npm run dev

Frontend pyörii nyt osoitteessa: http://localhost:3000

🧪 Testaa että kaikki toimii

1. Avaa selain

Mene osoitteeseen: http://localhost:3000

2. Rekisteröidy

  • Klikkaa "Rekisteröidy"
  • Syötä sähköposti ja salasana
  • Klikkaa "Rekisteröidy"

3. Kirjaudu sisään

  • Syötä sähköposti ja salasana
  • Klikkaa "Kirjaudu"

4. Tarkista Dashboard

Sinun pitäisi nähdä:

  • Kurssit (jos tietokannassa on kursseja)
  • Käyttäjäprofiili
  • Navigaatio

🗄️ Lisää kurssisisältö tietokantaan

SQLite (kehitys)

cd backend
python3
from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker
from main_api import Base, Course

# Luo tietokanta
engine = create_engine("sqlite:///./agenttiarmeija.db")
Base.metadata.create_all(bind=engine)

# Luo sessio
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
db = SessionLocal()

# Lisää kurssit
courses = [
    {
        "module_number": 1,
        "title": "AI-Agenttien Perusteet",
        "description": "Opi ReAct-kehys ja rakenna ensimmäinen AI-agenttisi",
        "duration_hours": 6.0,
        "content": "# Moduuli 1: AI-Agenttien Perusteet\n\n...",
        "order": 1,
        "is_published": True
    },
    {
        "module_number": 2,
        "title": "Kielimallien Tehokas Käyttö",
        "description": "Hallitse OpenAI, Anthropic ja Google AI -mallit",
        "duration_hours": 7.0,
        "content": "# Moduuli 2: Kielimallien Tehokas Käyttö\n\n...",
        "order": 2,
        "is_published": True
    },
    # ... lisää muut moduulit
]

for course_data in courses:
    course = Course(**course_data)
    db.add(course)

db.commit()
print("✅ Kurssit lisätty!")

🚀 Deploy tuotantoon

Backend (Railway)

./deploy_railway.sh

Muista:

  1. Lisää ympäristömuuttujat Railway dashboardissa
  2. Lisää PostgreSQL-tietokanta Railway dashboardissa
  3. Kopioi DATABASE_URL ympäristömuuttujiin

Frontend (Vercel)

./deploy_vercel.sh

Muista:

  1. Päivitä .env.production Railway backend URL:lla
  2. Päivitä Railway backend FRONTEND_URL Vercel URL:lla

🔑 Tärkeät ympäristömuuttujat

Backend (.env)

# PAKOLLINEN
JWT_SECRET_KEY=your-super-secret-key-change-this

# PAKOLLINEN (tuotannossa)
DATABASE_URL=postgresql://user:password@localhost:5432/agenttiarmeija

# AI-tuutori (valinnainen)
QWEN_API_KEY=sk-or-v1-...

# Maksut (valinnainen)
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# CORS
FRONTEND_URL=http://localhost:3000

Frontend (.env)

VITE_API_URL=http://localhost:8000

📝 Seuraavat askeleet

  1. Lisää kurssisisältö - Lataa kaikki 6 moduulia tietokantaan
  2. Konfiguroi Stripe - Luo tuotteet ja hinnoittelu
  3. Testaa AI-tuutori - Kysy kysymyksiä ja tarkista vastaukset
  4. Testaa DePIN-mining - Aloita mining ja tarkista tuotot
  5. Deploy tuotantoon - Railway + Vercel

🐛 Yleisimmät ongelmat

Backend ei käynnisty

# Tarkista että riippuvuudet on asennettu
pip3 list | grep fastapi

# Tarkista että portti 8000 on vapaa
lsof -i :8000

# Tarkista .env-tiedosto
cat .env

Frontend ei yhdistä backendiin

# Tarkista että backend pyörii
curl http://localhost:8000/health

# Tarkista .env-tiedosto
cat .env

# Tarkista browser console virheistä
# (Avaa Developer Tools: F12)

Tietokanta-virheet

# Luo tietokanta uudelleen
rm agenttiarmeija.db
python3
>>> from main_api import Base, engine
>>> Base.metadata.create_all(bind=engine)
>>> exit()

📞 Tuki

Tekninen tuki: agenttiarmeija@pinnacore.ai
Dokumentaatio: README.md
Deployment-ohjeet: deployment/DEPLOYMENT_GUIDE.md

Onnea projektiin! 🎉