Zespół Aladdin/ai

We build AI-powered tools that actually work. From cloud architecture to intelligent automation — we design, deploy, and maintain systems that make teams faster.

Anna (Ania) Kubasiak, PhD

Team Lead

AI engineering, cloud architecture, product strategy

Ola

Chief Growth & Product

Rozwija sprzedaż, automatyzuje marketing, współtworzy produkty. Wcześniej platformy e-commerce i strategie digital dla CD PROJEKT, Maczfit i Matras. Twórczyni Fun in Design.

Jeremi

—

Kim jesteśmy

Zespół inżynierów AI z siedzibą w Polsce. Projektujemy i wdrażamy systemy, które zmieniają sposób pracy naszych klientów — od automatyzacji procesów po inteligentne produkty użytkownika końcowego.

Na każdym etapie — od dzielenia się wiedzą, przez strategię, po wdrożenie. Bo dziś wszystkie te etapy przyspieszyły i nie ma sensu robić ich osobno.

Nie za rok. Teraz.

Co robimy

AI Engineering

Projektujemy i wdrażamy systemy oparte na LLM — od promptów po pełne pipeline'y produkcyjne.

Case Study: Szkolenia AI dla pharma

Cykl szkoleń z AI dla zespołów w branży farmaceutycznej — od podstaw LLM po praktyczne zastosowania w dokumentacji, compliance i analizie danych klinicznych.

Big Pharma · 2025

Budujemy

Produkty, platformy, infrastrukturę — od pomysłu do produkcji na GCP, Firebase i Cloud Run.

Case Study: DrugsMix Checker

Migracja z monolitu na Cloud Run + Firebase. Zero downtime, koszty hostingu spadły o 70%, auto-scaling przy 10x ruchu podczas kampanii marketingowej.

DrugsMix · 2025

Automatyzujemy

CI/CD, monitoring, deploy, raportowanie — wszystko co można zautomatyzować.

Case Study: API Monitor

Wewnętrzny system monitorowania kosztów AI — proxy keys, cache-aware pricing, per-user tracking. Zespół widzi kto ile wydaje, w czasie rzeczywistym. Wykrywa anomalie automatycznie.

AladdinAI Internal · 2026

Dzielimy się wiedzą i pasją

Szkolenia, warsztaty, consulting — pomagamy zespołom wejść w AI na własnych zasadach.

Case Study: Testy Psychologiczne

Platforma automatyzująca pracę poradni psychologicznej — pacjent wypełnia testy online, system generuje wyniki i interpretacje dla lekarza. Mniej papieru, szybsza diagnoza, więcej czasu na pacjenta.

Poradnia psychologiczna · 2025

Jak pracujemy

Krótkie cykle, ciągły feedback, wspólna odpowiedzialność za wynik. Wolimy pokazać działający prototyp niż prezentację o tym, co moglibyśmy zbudować.

AladdinAI · Environment

Zacznij tutaj

Jeden instalator skonfiguruje Ci całe środowisko. Zajmie ~5 minut.

Zainstaluj
środowisko

Co zostanie zainstalowane

Konfiguracja AI

~/.claude/ — instrukcje, preferencje, skills

about-me.md — Twój profil (AI dostosowuje odpowiedzi)

.env — klucze API (przez bezpieczny proxy)

~/.aladdinai/ — rejestr organizacji

Repozytoria i narzędzia

Sklonowane repo: team-docs, STARTER, claude-skills

Szablony dokumentacji (6-file docs)

Skills i hooks podłączone

Brand assets (logo, kolory, fonty)

Już masz środowisko? Uruchom instalator ponownie — sprawdzi co masz i tylko wyśle raport.

AladdinAI · File Structure

Organizacja plików

Każdy projekt ma swoje pliki konfiguracyjne. Są też globalne pliki które obowiązują wszędzie.

GLOBAL — ~/.claude/ (obowiązuje wszędzie)

Dokumenty konfiguracyjne

Plik	Co robi	Kto tworzy
`CLAUDE.md`	Główne instrukcje dla AI — jak się zachowywać, startup checklist, prompt protocol	Instalator
`about-me.md`	Profil użytkownika — rola, preferencje, języki. AI dostosowuje odpowiedzi	Instalator
`REFERENCE.md`	Dokumentacja referencyjna: YOLO mode, Projects Registry, 6-file standard	Instalator
`CODING_GUIDE.md`	Konwencje kodowania: Python snake_case, commit format, error handling, logging	Instalator
`REGISTRY.md`	Master lista projektów, URLi, serwisów, DNS, credentials info	Instalator + Claude aktualizuje
`GENERAL_LEARNINGS.md`	Odkrycia ważne dla wszystkich projektów (cross-project)	Claude dopisuje

Automatyzacja (Claude Code system)

Element	Gdzie	Co robi	Kto tworzy
Hooks	`settings.json`	Automatyczne akcje: prompt protocol na każdy prompt	Instalator
Skills	`skills/`	Custom komendy: /project --new, /env, /deploy, /handoff	Instalator wybierz i zaimportuj co potrzebujesz
MCP servers	`mcp.json`	Integracje: Chrome DevTools, Gmail, Drive, Calendar	Instalator
Memory	`memory/`	AI pamięta kontekst między sesjami — preferencje, decyzje, feedback	Claude tworzy automatycznie

Dane i szablony

Element	Gdzie	Co robi	Kto tworzy
Projects registry	`projects-registry/`	JSON per projekt: stack, URLs, porty, run scripts, env vars	Instalator + Claude
Templates	`templates/`	Szablony 6-file docs — kopiujesz do nowego projektu	Instalator
Scripts	`scripts/`	Helper scripts: repo-healthcheck.sh, rotate-key.sh	Instalator wybierz i zaimportuj co potrzebujesz
Env vars	`.env`	Zmienne środowiskowe: API keys (Anthropic, OpenAI, Google, GitHub)	Instalator

PER PROJECT — 6-file docs (w .claude/ każdego repozytorium)

Plik	Co robi	Kiedy aktualizowac	Kto tworzy
`PROJECT.md`	Co to za projekt, scope, kluczowe pliki, stack	Rzadko — gdy zmienia się scope	/project --new skill
`STATUS.md`	Gdzie jesteśmy teraz — aktualny stan	Każda sesja (nadpisz)	/project --new Claude aktualizuje
`SESSIONS_LOG.md`	Historia sesji — kto, kiedy, co robił	Każda sesja (dopisz)	/project --new Claude dopisuje
`LEARNINGS.md`	Pułapki i odkrycia specyficzne dla projektu	Gdy coś odkryjemy	/project --new Claude dopisuje
`DEVELOPMENT_GUIDE.md`	Konwencje kodu tego projektu	Gdy się zmienia	/project --new
`SERVICE_CONFIG.md`	APIs, OAuth, hosting, URLs, credentials info	Gdy dodamy serwis	/project --new Claude aktualizuje
`.claude/CLAUDE.md`	Instrukcje AI specyficzne dla tego projektu (nadpisuje global)	Rzadko	/project --new

Szablony: użyj /project --new skill — utworzy strukturę projektu z 6-file docs automatycznie. Lub skopiuj z ~/.claude/templates/.

SHARED ASSETS — ~/.claude/assets/

Zasoby firmowe wspólne dla wszystkich projektów. Claude widzi je automatycznie (są w ~/.claude/).

Folder	Co zawiera	Do czego
`assets/logo/`	Logo AladdinAI — PNG, SVG, różne rozmiary, light/dark	Wstawianie logo do produktow, stron, prezentacji
`assets/brand/`	Kolorystyka (hex, RGB), fonty, brand guidelines	Spojny wyglad wszystkich produktow
`assets/photos/`	Zdjecia zespolu, avatary	Strony, profile, oferty
`assets/icons/`	Favicony, ikony firmowe	Strony, apki, PWA

Osobno: ~/.claude/trash/ — pliki przeniesione zamiast usuniętych (hook: no-delete-move-to-trash).

Wszystko opisane w REGISTRY.md — Claude wie co gdzie jest i po co.

Phase 0

Jak zrobić środowisko pracy

Zainstaluj narzędzia krok po kroku. Na końcu jest skrypt który sprawdzi czy wszystko działa.

Krok 1

GIT

Po co: Git to system kontroli wersji. Bez niego nie pobierzesz kodu z repozytorium, nie stworzysz brancha, nie zrobisz Pull Requesta. To fundament pracy zespołowej.

Dlaczego pierwszy: Wszystko zaczyna się od pobrania kodu — a do tego potrzebujesz Gita.

Jak zainstalować

Wybierz swój system operacyjny:

Windows

macOS

Linux

Pobierz instalator

Idź na git-scm.com/download/win — kliknij duży przycisk "Download".

Uruchom instalator

Kliknij pobrany plik .exe. Możesz zostawić wszystkie opcje domyślne — klikaj "Next" aż do końca.

Sprawdź czy działa

Otworz PowerShell lub CMD (naciśnij Win+R, wpisz cmd, Enter):

git --version
# Powinno pokazać np. "git version 2.44.0"

Skonfiguruj swoje dane

Git musi wiedzieć kim jesteś (to pojawi się w commitach):

git config --global user.name "Twoje Imię Nazwisko"
git config --global user.email "twoj@email.com"

Otwórz Terminal

Cmd+Space, wpisz "Terminal", Enter.

Zainstaluj przez Homebrew

Jeśli masz Homebrew:

brew install git

Jeśli nie masz Homebrew — Git zainstaluje się automatycznie gdy pierwszy raz wpiszesz git w terminalu (macOS zapyta czy zainstalować Xcode tools — kliknij "Install").

Sprawdź i skonfiguruj

git --version
git config --global user.name "Twoje Imię"
git config --global user.email "twoj@email.com"

Otwórz terminal

Ctrl+Alt+T (na większości dystrybucji).

Zainstaluj

# Ubuntu / Debian:
sudo apt install git

# Fedora:
sudo dnf install git

Sprawdź i skonfiguruj

git --version
git config --global user.name "Twoje Imię"
git config --global user.email "twoj@email.com"

Krok 2

NODE.JS

Po co: Node.js to silnik JavaScript. Bez niego nie zainstalujesz Firebase CLI ani Claude Code (oba to pakiety npm które przychodzą z Node).

Dlaczego teraz: Większość naszych narzędzi wymaga Node.js do instalacji.

Pobierz z nodejs.org

Idź na nodejs.org. Kliknij zielony przycisk LTS (Long Term Support). To jest stabilna wersja.

Zainstaluj

Uruchom pobrany plik. Klikaj "Next" — domyslne opcje sa OK. Na Windowsie moze zapytac o "Chocolatey" — możesz pominąć.

Sprawdź

Otwórz nowe okno terminala (ważne — nowe, nie stare!):

node --version   # powinno być >= 18
npm --version    # powinno być >= 9

Krok 3

VS CODE

Po co: Edytor kodu. Tutaj będziesz pisać i przeglądać pliki. Ma wbudowane wsparcie Git, terminal, i rozszerzenia.

Pobierz

Idź na code.visualstudio.com — kliknij "Download".

Zainstaluj rozszerzenia

Otwórz VS Code. Kliknij ikonę klocka z boku (Extensions, Ctrl+Shift+X). Wyszukaj i zainstaluj:

Rozszerzenie	Po co
ESLint	Pokazuje błędy w JavaScript
Prettier	Automatycznie formatuje kod
Live Server	Podgląd HTML w przeglądarce na żywo
Firebase Explorer	Przeglądanie bazy danych z edytora

Krok 4

FIREBASE CLI

Po co: Pozwala uruchamiać emulatory Firebase u siebie na komputerze (testowanie bez produkcji) i deployować na serwer.

Wymaga: Node.js (krok 2). Jeśli nie masz Node.js — wracaj do kroku 2!

Zainstaluj przez npm

npm install -g firebase-tools

Sprawdź

firebase --version   # powinno być >= 13.0

Krok 5 (opcjonalne)

CLAUDE CODE

Po co: AI asystent w terminalu. Pisze kod, robi code review, tworzy commity i Pull Requesty. Nie musisz go mieć, ale mocno ułatwia pracę.

Wymaga: Node.js (krok 2) + Git (krok 1) + klucz API Anthropic (dostaniesz od Anny)

Zainstaluj

npm install -g @anthropic-ai/claude-code

Ustaw klucz API

Klucz dostaniesz od team leadera. Ustaw go w terminalu:

# Windows (PowerShell):
$env:ANTHROPIC_API_KEY = "sk-ant-twoj-klucz"

# Mac/Linux:
export ANTHROPIC_API_KEY="sk-ant-twoj-klucz"

Uruchom w projekcie

cd aladdinai-platform
claude

# Przyklad: "przejrzyj pliki i opisz co robi ten projekt"
# Przyklad: "napraw błąd w admin.html"
# Przyklad: /commit

Krok 6 (tylko backend)

PYTHON 3.11+

Po co: Subprojekt excelapp (Document Tracker) jest napisany w Pythonie. Jeśli pracujesz tylko nad frontendem — nie musisz tego instalować.

Pobierz

python.org/downloads — wersja 3.11 lub nowsza.

Sprawdź

python --version   # >= 3.11

Krok 7 (dev+)

DOCKER DESKTOP

Po co: Konteneryzacja aplikacji i deploy na Cloud Run. Jeśli nie deployujesz — nie musisz tego instalować.

Pobierz

docker.com/products/docker-desktop — wybierz swój system.

Sprawdź

docker --version   # Docker version 2x+
docker compose version

Setup

Instalacja & auto-update

Jeden installer konfiguruje ~/.claude/, klonuje repo zespolu i wlacza auto-update na kazdym starcie sesji Claude Code.

Jak to dziala: Skrypt instalacyjny uruchamiasz z folderu, w ktorym chcesz miec repo AladdinAI (czyli z lokalizacji gdzie maja byc team-docs/, claude-skills/, STARTER/ jako bezposrednie podfoldery). Sciezka jest zapisywana w ~/.claude/scripts/.aladdinai-path — hooki sync od tej chwili wiedza gdzie szukac.

1. Wybierz folder i wejdz do niego

Np. ~/repos/, ~/projects/ — gdziekolwiek chcesz miec AladdinAI. Wejdz tam w terminalu:

# Linux / macOS / Git Bash:
cd ~/repos     # lub gdziekolwiek

2. Pobierz i uruchom installer

Linux / macOS / WSL / Git Bash:

bash <(curl -fsSL https://team-aladdinai.web.app/install.sh)

Windows (PowerShell):

iwr -useb https://team-aladdinai.web.app/install.ps1 | iex

Co dostajesz:

~/.claude/ — globalne instrukcje, skills, hooki, settings.json
4 wspolne repo sklonowane do biezacego folderu: team-docs/, STARTER/, claude-skills/, plus dowolne dodatkowe ktore juz tam masz
Auto-update: kazda zmiana ktora pushujemy do claude-skills ladzie u Ciebie przy nastepnym starcie Claude Code — bez Twojego dzialania
Sync wszystkich repo z main przy starcie sesji (tylko clean working tree — brudne sa pomijane z ostrzezeniem)

3. Aktualizacja w kazdej chwili

Jesli cos sie zepsuje albo chcesz wymusic re-sync wszystkich hookow — uruchom installer ponownie z tego samego folderu. Jest idempotentny: Twoje pliki osobiste (about-me.md, .env) nigdy nie sa nadpisywane.

Ostrzezenie: Hooki ktore instaluje ten skrypt MOGA UURUCHAMIAC ARBITRARY BASH na Twojej maszynie. Wszystko co commituje sie do Aladdinai-eu/claude-skills wykona sie u kazdego czlonka zespolu przy nastepnym SessionStart. Push tylko jesli rozumiesz co robisz; opt-out z telemetrii: export ALADDINAI_TELEMETRY=0.

API Monitor

Jak to działa? Klucz syntetyczny (am-...) działa tylko przez nasz proxy. Ustawiasz go jako ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL — Claude Code i SDK działają normalnie, a każde zapytanie jest logowane z Twoim imieniem i projektem.

this week

🏗️ Infra (GCP)

—

breakdown ▾

🔌 APIs (pay-per-use)

—

breakdown ▾

♾️ Subscriptions

—

breakdown ▾

🔑 Synthetic keys

Projekt / Label Provider

Klucz	Projekt	Provider	Kto	Zapytan	Koszt	Status

👤 Accounts & subscriptions

Ten widok pokazuje konta i subskrypcje oraz użycie raportowane przez hooki Claude Code.

Nazwa Provider Rodzaj dostępu

Projekt Login subskrypcji / konta

Plan Monthly cost ($) Next invoice

Notes

Nazwa	Provider	Rodzaj dostępu	Projekt	Login subskrypcji / konta	Użycie	Status

Team Repo Sync Status

Per-host state of the 4 team repos (brand-assets, team-docs, claude-skills, STARTER). Updated automatically on each team member's session start.

Host	Repo	Branch	Commit	Behind	Ahead	Dirty	Action	Last seen

Requests

AnthropicOpenAIGoogle

Remove heartbeats < tokens

Czas	Src	Kto	Projekt	Provider	Model	In	Out	Koszt	Status

AladdinAI · Linki

Zasoby zespołu

Aplikacje, repozytoria i narzędzia dostępne dla zespołu.

APP

DataAgent Demo

Agent do analizy danych w języku naturalnym — pytasz po polsku, dostajesz wykres i SQL. Login przez Google.

dataagentdemo.web.app/app →

CODE

GitHub — Aladdinai-eu

Organizacja GitHub z całym kodem zespołu. Wszystkie repozytoria są prywatne — wymagany dostęp.

github.com/Aladdinai-eu →

MARKETING

Marketing — Video Pipeline

Wewnętrzny dashboard marketingowy — pipeline wideo, treści, kampanie.

marketing-aladdinai.web.app →

Aladdin/ai

Zespół Aladdin/ai

Anna (Ania) Kubasiak, PhD

Ola

Jeremi

Kim jesteśmy

Co robimy

AI Engineering

Case Study: Szkolenia AI dla pharma

Budujemy

Case Study: DrugsMix Checker

Automatyzujemy

Case Study: API Monitor

Dzielimy się wiedzą i pasją

Case Study: Testy Psychologiczne

Jak pracujemy

Stack, secrets & admin at a glance.

Zacznij tutaj

Konfiguracja AI

Repozytoria i narzędzia

Organizacja plików

GLOBAL — ~/.claude/ (obowiązuje wszędzie)

Dokumenty konfiguracyjne

Automatyzacja (Claude Code system)

Dane i szablony

PER PROJECT — 6-file docs (w .claude/ każdego repozytorium)

SHARED ASSETS — ~/.claude/assets/

Jak zrobić środowisko pracy

GIT

Jak zainstalować

Pobierz instalator

Uruchom instalator

Sprawdź czy działa

Skonfiguruj swoje dane

Otwórz Terminal

Zainstaluj przez Homebrew

Sprawdź i skonfiguruj

Otwórz terminal

Zainstaluj

Sprawdź i skonfiguruj

NODE.JS

Pobierz z nodejs.org

Zainstaluj

Sprawdź

VS CODE

Pobierz

Zainstaluj rozszerzenia

FIREBASE CLI

Zainstaluj przez npm

Sprawdź

CLAUDE CODE

Zainstaluj

Ustaw klucz API

Uruchom w projekcie

PYTHON 3.11+

Pobierz

Sprawdź

DOCKER DESKTOP

Pobierz

Sprawdź

Instalacja & auto-update

1. Wybierz folder i wejdz do niego

2. Pobierz i uruchom installer

Linux / macOS / WSL / Git Bash:

Windows (PowerShell):

3. Aktualizacja w kazdej chwili

API Monitor

🔑 Synthetic keys

👤 Accounts & subscriptions

Team Repo Sync Status

Zasoby zespołu

DataAgent Demo

GitHub — Aladdinai-eu

Marketing — Video Pipeline