Bilagspilot

AI-basert bilagsassistent for små håndverksbedrifter

Bilagspilot er et porteføljeprosjekt som viser hvordan AI kan spare tid i første del av bilagsarbeid. Appen leser fakturaer og kvitteringer, foreslår nøkkelfelt, lar brukeren kontrollere og rette data, og eksporterer godkjente bilag til CSV.

Dette er en demo, ikke et godkjent regnskapssystem.

Demo

Hva appen gjør

• Laster opp PDF, PNG og JPG.
• Bruker OpenAI Vision/API til å hente ut leverandør, dato, totalbeløp, MVA, valuta, bilagsnummer og kategori.
• Viser resultatet i et redigerbart skjema.
• Merker bilag som OK, Må sjekkes eller Mangler data.
• Lagrer godkjente bilag i SQLite.
• Eksporterer godkjente bilag til CSV.

Tech stack

• Backend: Python, FastAPI, SQLite
• Frontend: React, Vite, TypeScript
• AI: OpenAI Responses API med bilde/PDF-input
• Eksport: CSV

Klon repoet

git clone https://github.com/wessel05j/bilagspilot.git

Kjør backend

Windows PowerShell:

cd bilagspilot\backend
py -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env
uvicorn app.main:app --reload

Linux/macOS Bash:

cd bilagspilot/backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp -n .env.example .env
uvicorn app.main:app --reload

Ikke bruk Bash-kommandoer med && i gammel Windows PowerShell. Bruk PowerShell-blokken over.

Legg inn din egen API-nøkkel i backend/.env:

OPENAI_API_KEY=your_key_here

Backend kjører på http://localhost:8000.

Kjør frontend

Frontend kjøres i en annen terminal. Kjør kommandoene fra mappen der du klonet repoet.

Windows PowerShell:

cd bilagspilot\frontend
npm install
npm run dev

Linux/macOS Bash:

cd bilagspilot/frontend
npm install
npm run dev

Frontend kjører på http://localhost:5173.

Demo-flyt

1. Start backend og frontend.
2. Åpne http://localhost:5173.
3. Last opp et falskt bilag, for eksempel demo/fake-bilag.pdf.
4. Kontroller feltene AI foreslår.
5. Rett eventuelle feil direkte i skjemaet.
6. Trykk Godkjenn, eller Avvis og slett hvis bilaget ikke skal brukes.
7. Trykk Eksporter CSV for godkjente bilag.

Vanlige problemer

Hvis frontend sier at OPENAI_API_KEY mangler selv om du har lagt den inn:

1. Sjekk at nøkkelen ligger i backend/.env, ikke bare i .env.example.
2. Restart backend etter at du har endret .env.
3. Åpne http://localhost:8000/api/health og se at openai_configured er true.
4. Hvis backend kjører på en annen port enn 8000, oppdater frontend/.env med riktig VITE_API_BASE_URL.

Hvis PowerShell sier at && ikke fungerer, bruk Windows PowerShell-kommandoene i README.

Tester

Backend:

cd backend
pytest

Frontend:

cd frontend
npm test
npm run build

Miljøvariabler

Backend bruker backend/.env lokalt. Eksempel ligger i backend/.env.example.

Viktige variabler:

• OPENAI_API_KEY
• OPENAI_MODEL
• DATABASE_URL
• UPLOAD_DIR
• FRONTEND_ORIGIN

Frontend kan bruke frontend/.env hvis API-adressen skal endres:

VITE_API_BASE_URL=http://localhost:8000

Sikkerhet og personvern

• Ikke commit .env.
• Ikke commit uploads/.
• Ikke commit lokal SQLite-database.
• Ikke bruk ekte kundedata eller ekte bilag i demo.
• Bruk bare syntetiske testbilag.

Begrensninger

• Appen er ikke et regnskapssystem.
• AI-forslag må alltid kontrolleres av et menneske.
• CSV-eksporten er enkel og laget for demo/portefølje.
• Det finnes ikke innlogging eller rollebasert tilgang ennå.

Lisens

MIT

Videre arbeid

• Excel-eksport.
• Bedre håndtering av flere sider og store PDF-er.
• Innlogging.
• Flere kategorier og regler per bedrift.
• Bedre revisjonsspor for manuelle endringer.