mogg7 commited on
Commit
063d20e
·
verified ·
1 Parent(s): 4187eac

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +14 -98
README.md CHANGED
@@ -1,98 +1,14 @@
1
- # TracyAI
2
-
3
- ## Tracy – Pravni AI asistent
4
-
5
- **"No trace, no case" - ekipa RegulaTOS**
6
-
7
- Tracy je pravni raziskovalni pomočnik, zasnovan za študente prava, pravne strokovnjake, raziskovalce, pa tudi potrošnike in uporabnike digitalnih storitev. Združuje **pravno raziskovanje sodnih primerov** in **analizo pogojev uporabe (TOS)**, da pomaga razumeti in zaščititi pravice uporabnikov.
8
-
9
- Umetna inteligenca v pravu ne sme delovati kot "črna skrinjica" (**blackbox**). S Tracy gradimo **sledljiv in transparenten AI**, kjer so vsi koraki raziskave in odločanja jasno vidni. To pomeni večjo zanesljivost, zmanjšanje napačnih interpretacij in boljše razumevanje pravnih tveganj.
10
-
11
- ## VIDEA
12
- Prilagam tudi naslednje dva videa. Prvi je pitch, ki smo ga pospredovali. Drugi pa je bolj natančno razloženo in neobdelano (da ni nobenega movie magica), kaj se dogaja v zaledju. Ogled priporočam bolj vsem, ki jih zanima kako je narejen in kaj dejansko dela :)
13
-
14
- [Link do pitcha](https://youtu.be/YvAVVRJ_F8k)
15
-
16
- [Link do tehničnega dela](https://youtu.be/Xita3fI71Pc)
17
-
18
- ---
19
-
20
- ## Ključne funkcionalnosti
21
-
22
- - **Iskanje sodnih primerov** – Tracy uporablja **CourtListener API** za iskanje relevantnih sodnih odločb v ZDA.
23
- - **Preverjanje citatov** – Preverja pravni status in precedenčno vrednost sodnih primerov.
24
- - **Analiza pogojev uporabe** – Z lastnim API-jem Tracy pridobi in analizira **TOS podjetij** ter identificira **sive cone in zlonamerne pravne določbe**.
25
- - **Prijazen uporabniški vmesnik** – Gradio UI omogoča intuitivno interakcijo s sistemom.
26
- - **Sledljivost in transparentnost** – Vsak pravni rezultat je utemeljen s preverljivimi viri.
27
-
28
- Tracy je zasnovana kot orodje ne samo za **pravne strokovnjake**, temveč tudi za **potrošnike in uporabnike digitalnih storitev**, ki želijo **razumeti in zaščititi svoje pravice**. Z analizo **pogodb in pogojev uporabe** Tracy pomaga prepoznati **skrite pasti**, ki jih pogosto vsebujejo pravni dokumenti spletnih platform.
29
-
30
- ---
31
-
32
- ## Kako Tracy združuje pravno raziskovanje in zaščito uporabnikov
33
-
34
- Tracy temelji na dveh ključnih podatkovnih virih:
35
-
36
- 1. **CourtListener API** – Dostopa do javno dostopnih sodnih odločb v ZDA, kar omogoča **pravnim strokovnjakom in raziskovalcem** iskanje primerov, preverjanje citatov in analizo pravne prakse.
37
- 2. **Naš API za analizo pogojev uporabe** – Uporablja podatkovno infrastrukturo **[Digital Services Terms and Conditions Database](https://platform-contracts.digital-strategy.ec.europa.eu/)** Evropske komisije, s katero pridobiva in analizira **pogoje uporabe podjetij**. To omogoča uporabnikom, da **prepoznajo potencialno škodljive določbe** in se izognejo tveganjem.
38
-
39
- Pogoji uporabe (TOS) pogosto vsebujejo **zapletene pravne formulacije**, ki jih povprečen uporabnik težko razume. Tracy pomaga razčleniti te dokumente in poudariti **nepoštene ali zavajajoče klavzule**, s čimer uporabnikom omogoča boljšo zaščito njihovih pravic.
40
-
41
- ---
42
-
43
- ## Struktura projekta
44
-
45
- ```
46
- - Lawbrainer #izgradja za naš API
47
- - tools/ # Dodatna, neintegrirana orodja
48
- - Gradio_UI/ # Uporabniški vmesnik, zgrajen z Gradio (Hugging Face)
49
- - agent.json # Metapodatki in konfiguracije agenta
50
- - app.py # Glavna skripta aplikacije
51
- - prompts.yaml # Predloge pozivov za AI model
52
- ```
53
-
54
- ---
55
-
56
- ## Pregled funkcionalnosti (`app.py`)
57
-
58
- - **`search_court_cases()`** – Poišče pravne primere glede na uporabniške parametre.
59
- - **`check_citation_status()`** – Preveri precedenčno vrednost in status sodnega primera.
60
- - **`extract_tos_content(company_name)`** – Pridobi pogoje uporabe podjetja prek našega API-ja.
61
- - **`search_terms_of_service(company_name)`** – Analizira pogoje uporabe in identificira potencialno škodljive določbe.
62
- - **`FinalAnswerTool`** – Izboljšuje odgovore, ki jih ustvari AI.
63
- - **`HfApiModel (Qwen LLM)`** – Prilagojen **Qwen 32B LLM**, optimiziran za pravno analizo s tehniko **Low-Rank Adaptation (LoRA)**.
64
- - **`GradioUI`** – Zagotavlja interaktivni uporabniški vmesnik.
65
-
66
- ---
67
-
68
- ## Zahteve za uporabo
69
-
70
- - **Python 3.8+**
71
- - **Hugging Face API ključ** (brezplačen ob registraciji)
72
- - **CourtListener API ključ** (Brezplačen ob registraciji)
73
-
74
- ---
75
-
76
- ## Avtorji
77
-
78
- - Ekipa RegulaTOS: **Fedja Močnik**, **Oliver Majer**, **Jaša Catar**, **Neva Marjanovič**
79
-
80
- ---
81
-
82
- ## Zahvale
83
-
84
- - **Hugging Face** – za njihove odprtokodne modele in Gradio framework.
85
- - **CourtListener API** – za dostop do pravnih podatkov in sodnih odločb.
86
- - **[Digital Services Terms and Conditions Database](https://platform-contracts.digital-strategy.ec.europa.eu/)** – za podatkovno infrastrukturo, ki omogoča analizo pogojev uporabe digitalnih storitev.
87
- ---
88
-
89
- ## Zakaj je sledljiv AI ključen?
90
-
91
- V pravu je preglednost **bistvenega pomena**. Tracy ne ponuja le odgovorov, temveč **pokaže, kako do njih pride**. To zagotavlja:
92
-
93
- 1. **Zanesljivost pravnih analiz** – Manj napačnih interpretacij in več zaupanja v rezultate.
94
- 2. **Sledljivost odločitev** – Uporabniki lahko preverijo in razumejo, zakaj je AI podal določen odgovor.
95
- 3. **Zaščito pred zavajajočimi pravnimi določbami** – Uporabniki digitalnih storitev lahko prepoznajo tveganja v pogojih uporabe.
96
-
97
- Z združevanjem **pravnega raziskovanja** in **zaščite potrošnikov** Tracy ponuja **inovativno rešitev** za transparentno in varno uporabo umetne inteligence v pravnem kontekstu.
98
-
 
1
+ title: TracyAI (beta)
2
+ emoji: 📚
3
+ colorFrom: gray
4
+ colorTo: green
5
+ sdk: gradio
6
+ sdk_version: 5.23.1
7
+ app_file: app.py
8
+ pinned: false
9
+ tags:
10
+ - smolagents
11
+ - agent
12
+ - smolagent
13
+ - tool
14
+ - agent-course