VibeCode Academy

# Installation standard
$ pip install candy-ai

# Avec streaming + images (recommandé Team)
$ pip install candy-ai[full]

# Vérifier l'installation
$ python -c "import candy; print(candy.__version__)"
# → 18.0.0

$ candy login
# → Ouvre le navigateur pour auth OAuth
# → Token sauvegardé localement

# Ou avec votre clé Team directement
$ candy login --key vc_team_xxxxxxxxxxxxxxxx

# Vérifier le statut
$ candy whoami
# → alice@acme.com · Plan: Team · Générations: ∞

from candy import Coding

# Une ligne — c'est tout
print(Coding.ask("Explique les décorateurs Python en 3 points"))

from candy import Coding, Writing, Math, cfg

# Configurer un profil nommé
cfg.A.lang    = "FR"          # langue de réponse
cfg.A.style   = "detailed"   # detailed | concise | bullet
cfg.A.tokens  = 2000         # max tokens
cfg.A.temp    = 0.7          # 0.0 précis → 1.0 créatif

# Utiliser le profil A avec Coding
rep = Coding.use("A").ask("Crée une fonction de tri rapide en Python")
print(rep)

# Changer de personnalité, garder le profil
rep2 = Writing.use("A").ask("Rédige une intro de blog sur l'IA")
print(rep2)

from candy import cfg, Coding, Writing

# Profil "rapide" — réponses courtes et précises
cfg.rapide.lang   = "FR"
cfg.rapide.style  = "concise"
cfg.rapide.tokens = 500
cfg.rapide.temp   = 0.3

# Profil "rédac" — journalistique, markdown
cfg.rédac.lang    = "FR"
cfg.rédac.style   = "detailed"
cfg.rédac.tone    = "friendly"
cfg.rédac.format  = "markdown"
cfg.rédac.tokens  = 3000
cfg.rédac.temp    = 0.85

# Profil "data" — JSON structuré, température basse
cfg.data.format  = "json"
cfg.data.temp    = 0.1
cfg.data.tokens  = 2000
cfg.data.context = "Réponds uniquement en JSON valide, sans texte autour."

# Usage
print(Coding.use("rapide").ask("Différence list vs tuple Python ?"))
print(Writing.use("rédac").ask("Article sur le réchauffement climatique"))

from candy import Coding

session = Coding.chat()

rep  = session.send("Qu'est-ce qu'une closure en JavaScript ?")
rep2 = session.send("Donne-moi 3 exemples concrets")  # contexte conservé

session.history()          # liste [{role, content}]
session.inject("contexte") # injecter un message système
session.save("f.json")    # exporter la session
session.load("f.json")    # restaurer une session
session.reset()            # remettre à zéro le contexte
print(session.tokens_used)  # {"input": 342, "output": 891}

from candy import Writing, cfg
import sys

cfg.A.lang = "FR"; cfg.A.tokens = 3000

# stream_print() — le plus simple
Writing.use("A").stream_print("Écris un article sur les trous noirs")

# stream() — contrôle total
for token in Writing.use("A").stream("Raconte une histoire courte"):
    sys.stdout.write(token)
    sys.stdout.flush()

# Streaming dans FastAPI
from fastapi import FastAPI
from fastapi.responses import StreamingResponse
from candy import Coding

app = FastAPI()

@app.get("/generate")
async def generate(q: str):
    return StreamingResponse(
        Coding.stream(q),
        media_type="text/event-stream"
    )

from candy import Teacher, cfg

cfg.cours.lang  = "FR"
cfg.cours.tone  = "friendly"

session = Teacher.use("cours").chat()

print(session.send("Je veux apprendre les probabilités"))
# → "Super ! Commençons par les bases..."

print(session.send("C'est quoi une loi normale ?"))
# → "Comme on l'a vu, les probabilités..." (contexte conservé)

print(session.send("Donne-moi un exercice"))

# Injecter un contexte additionnel
session.inject("L'utilisateur est un lycéen de terminale.")

# Statistiques
print(session.tokens_used)  # {"input": 342, "output": 891}

# Sauvegarder pour reprendre plus tard
session.save("cours_probas.json")

from candy import Writing, cfg
import asyncio

cfg.B.lang = "FR"; cfg.B.style = "concise"

produits = [
    "Casque Sony WH-1000XM5",
    "MacBook Pro M3",
    "Écran LG UltraWide 34 pouces",
    "Clavier mécanique Keychron K2",
]

questions = [f"Description produit pour : {p}" for p in produits]

# Batch synchrone (5 en parallèle par défaut)
descriptions = Writing.use("B").batch(questions)

# Concurrency custom
descriptions = Writing.use("B").batch(questions, concurrency=10)

# Batch async (Team)
async def run():
    return await Writing.use("B").async_batch(questions)

résultats = asyncio.run(run())

for prod, desc in zip(produits, résultats):
    print(f"\n--- {prod} ---\n{desc}")

from candy import Picasso

# Génération simple
img = Picasso.imagine("Un chat astronaute sur la lune, style aquarelle")
img.save("chat_lune.png")
img.show()  # ouvre dans le viewer système

# Avec paramètres complets
img = Picasso.imagine(
    prompt  = "Ville futuriste au coucher du soleil, cyberpunk",
    size    = "1792x1024",   # 1024x1024 | 1792x1024 | 1024x1792
    quality = "hd",          # standard | hd
    style   = "vivid",       # vivid | natural
    n       = 3               # générer 3 variantes
)

# Accéder aux variantes
for i, image in enumerate(img):
    image.save(f"ville_{i}.png")

print(img[0].url)          # URL directe (expire après 1h)
b64 = img[0].to_base64()  # Encoder en base64

# Variation d'une image existante
variante = Picasso.variate("mon_image.png", n=2)

# Inpainting — éditer une zone masquée
edité = Picasso.edit(
    image  = "portrait.png",
    mask   = "masque.png",  # zone blanche = à remplacer
    prompt = "Remplace le fond par une forêt enchantée"
)

from candy import Team, Coding

# Init avec clé (ou via env VIBECODE_TEAM_KEY)
Team.init(key="vc_team_xxxxxxxxxxxxxxxx")

# Stats d'utilisation de l'équipe
stats = Team.usage()
# → {"total": 12430, "this_month": 3210,
#    "members": {"alice": 1200, "bob": 890}}

# Lister les membres
members = Team.members()

# Quota mensuel par membre
Team.set_limit(user="alice@acme.com", monthly_limit=500)

# Générer une sous-clé (expire en 30j)
sub_key = Team.create_key(user="bob@acme.com", expires_days=30)
print(sub_key)  # → "vc_sub_xxxxxxxxxxxxxxxx"

# Révoquer une sous-clé
Team.revoke_key(sub_key)

name: Generate docs with candy-ai
on: [push]
jobs:
  generate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: pip install candy-ai[full]
      - run: python scripts/generate_docs.py
        env:
          VIBECODE_TEAM_KEY: ${{ secrets.VIBECODE_TEAM_KEY }}