lannotex 0.1.0__py3-none-any.whl

lannotex/team.py

@@ -0,0 +1,248 @@
+"""Explicit, authenticated team hosting. SQLite is accessed only on the host.
+
+Desktop clients keep private local replicas and an outbox. HTTP work runs in jobs,
+never the Qt UI thread. Plain HTTP is for trusted LAN/VPN; CLI supports TLS.
+"""
+from __future__ import annotations
+import hashlib
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+import json
+import os
+from pathlib import Path
+import secrets
+import ssl
+import tempfile
+import threading
+from urllib.error import HTTPError
+from urllib.parse import parse_qs, urlparse
+from urllib.request import Request, urlopen
+import uuid
+from . import __version__
+from .domain import Annotation, validate_all
+from .storage import ConflictError, Project
+
+
+def add_member(root, name):
+    if not name.strip() or len(name)>120: raise ValueError('Enter a reviewer name of 1–120 characters')
+    token=secrets.token_urlsafe(32); project=Project(root,create=False)
+    try:
+        with project.conn:
+            project.conn.execute('INSERT INTO team_members(id,name,token_hash) VALUES(?,?,?)',
+                                 (uuid.uuid4().hex,name.strip(),hashlib.sha256(token.encode()).hexdigest()))
+        return token
+    finally: project.close()
+
+
+class TeamServer(ThreadingHTTPServer):
+    daemon_threads=True
+    def __init__(self, root, host='127.0.0.1', port=8765, cert=None, key=None):
+        self.root=Path(root).resolve()
+        project=Project(self.root,create=False)
+        if not project.setting('project_id'): project.set_setting('project_id',str(uuid.uuid4()))
+        project.close()
+        super().__init__((host,port),TeamHandler)
+        if cert:
+            context=ssl.SSLContext(ssl.PROTOCOL_TLS_SERVER); context.load_cert_chain(cert,key)
+            self.socket=context.wrap_socket(self.socket,server_side=True)
+        self.thread=None
+
+    def start(self):
+        self.thread=threading.Thread(target=self.serve_forever,daemon=True); self.thread.start(); return self
+
+    def stop(self):
+        self.shutdown(); self.server_close()
+        if self.thread: self.thread.join(timeout=3)
+
+
+class TeamHandler(BaseHTTPRequestHandler):
+    server_version=f'Lannotex/{__version__}'
+    def log_message(self,*args): pass  # Never log access tokens or private image names.
+
+    def reply(self,code,payload):
+        raw=json.dumps(payload).encode()
+        self.send_response(code); self.send_header('Content-Type','application/json')
+        self.send_header('Content-Length',str(len(raw))); self.send_header('Cache-Control','no-store'); self.end_headers(); self.wfile.write(raw)
+
+    def do_GET(self): self.dispatch(False)
+    def do_PUT(self): self.dispatch(True)
+
+    def dispatch(self,write):
+        project=None
+        try:
+            self.connection.settimeout(15)
+            project=Project(self.server.root,create=False)
+            token=self.headers.get('Authorization','').removeprefix('Bearer ')
+            member=project.conn.execute('SELECT * FROM team_members WHERE token_hash=? AND active=1',(hashlib.sha256(token.encode()).hexdigest(),)).fetchone()
+            if not member: self.reply(401,{'error':'Invalid or revoked reviewer token'}); return
+            parsed=urlparse(self.path); route=parsed.path.strip('/').split('/'); query=parse_qs(parsed.query)
+            if route==['meta'] and not write:
+                self.reply(200,{'project_id':project.setting('project_id'),'name':project.setting('name',project.root.name),
+                    'tasks':project.setting('tasks',['box','polygon','classification']),'labels':[dict(r) for r in project.labels()],
+                    'reviewer':member['name']}); return
+            if route==['changes'] and not write:
+                project.conn.execute('BEGIN')
+                after=max(0,int(query.get('after',['0'])[0]))
+                changes=project.conn.execute('SELECT seq,image_id FROM team_changes WHERE seq>? ORDER BY seq LIMIT 128',(after,)).fetchall()
+                images=[]
+                for ident in dict.fromkeys(r['image_id'] for r in changes):
+                    row=project.image(ident)
+                    if row:
+                        data=dict(row); data['path']=Path(data['path']).name
+                        data['revision']=project.conn.execute('SELECT revision FROM revisions WHERE image_id=?',(ident,)).fetchone()[0]
+                        images.append(data)
+                self.reply(200,{'images':images,'cursor':changes[-1]['seq'] if changes else after,'more':len(changes)==128}); return
+            if len(route)!=2 or route[0] not in ('state','image') or not route[1].isdigit(): self.reply(404,{'error':'Unknown endpoint'}); return
+            ident=int(route[1]); image=project.image(ident)
+            if image is None: self.reply(404,{'error':'Unknown image'}); return
+            if route[0]=='image' and not write:
+                path=project.resolve(image['path'])
+                # IDs resolve exclusively through project records, never URL paths.
+                with path.open('rb') as stream:
+                    size=os.fstat(stream.fileno()).st_size
+                    if size>256*1024*1024: self.reply(413,{'error':'Image exceeds 256 MiB transfer limit'}); return
+                    self.send_response(200); self.send_header('Content-Type','application/octet-stream'); self.send_header('Content-Length',str(size)); self.end_headers()
+                    while chunk:=stream.read(1024*1024): self.wfile.write(chunk)
+                return
+            if route[0]!='state': self.reply(405,{'error':'Method not allowed'}); return
+            if write:
+                size=int(self.headers.get('Content-Length','0'))
+                if not 0<size<=4*1024*1024: self.reply(413,{'error':'Annotation payload must be under 4 MiB'}); return
+                data=json.loads(self.rfile.read(size)); anns=[Annotation.from_dict(a) for a in data['annotations']]
+                if len(anns)>10000: raise ValueError('Too many annotations')
+                allowed=set(project.setting('tasks',['box','polygon','classification']))
+                if any(a.kind not in allowed for a in anns): raise ValueError('Annotation type is not enabled for this pipeline')
+                if not isinstance(data['revision'],int) or not isinstance(data['negative'],bool): raise ValueError('Invalid revision or no-target value')
+                project.save_annotations(ident,anns,data['negative'],actor=member['name'],expected_revision=data['revision'],clear_draft=False)
+            # A read transaction keeps revision, annotations and status consistent.
+            project.conn.execute('BEGIN')
+            revision=project.conn.execute('SELECT revision FROM revisions WHERE image_id=?',(ident,)).fetchone()[0]
+            annotations=project.load_annotations(ident); status=project.image(ident)['status']
+            self.reply(200,{'revision':revision,'annotations':[a.to_dict() for a in annotations],'negative':status=='empty','status':status})
+        except ConflictError as e: self.reply(409,{'error':str(e)})
+        except (ValueError,KeyError,TypeError) as e: self.reply(400,{'error':str(e)})
+        except FileNotFoundError: self.reply(404,{'error':'Source image is missing on the host'})
+        except (BrokenPipeError,ConnectionResetError): pass
+        except Exception: self.reply(500,{'error':'Host operation failed; no successful save was confirmed'})
+        finally:
+            if project: project.close()
+
+
+class TeamClient:
+    def __init__(self,url,token):
+        self.url=url.rstrip('/'); self.token=token
+        parsed=urlparse(self.url)
+        if parsed.scheme not in ('http','https') or not parsed.hostname or parsed.username or parsed.query or parsed.fragment:
+            raise ValueError('Enter a plain http:// or https:// host URL')
+
+    def request(self,path,data=None):
+        req=Request(self.url+path,data=json.dumps(data).encode() if data is not None else None,
+                    headers={'Authorization':'Bearer '+self.token,'Content-Type':'application/json'},method='PUT' if data is not None else 'GET')
+        try:
+            with urlopen(req,timeout=10) as response: return json.loads(response.read(8*1024*1024))
+        except HTTPError as e:
+            message=json.loads(e.read()).get('error',str(e))
+            if e.code==409: raise ConflictError(message) from e
+            raise ValueError(message) from e
+
+    def download(self,ident,path,cancel=None):
+        path=Path(path); path.parent.mkdir(parents=True,exist_ok=True)
+        req=Request(self.url+f'/image/{ident}',headers={'Authorization':'Bearer '+self.token})
+        fd,temp=tempfile.mkstemp(dir=path.parent,suffix='.part')
+        try:
+            with os.fdopen(fd,'wb') as stream, urlopen(req,timeout=15) as response:
+                total=0
+                while chunk:=response.read(1024*1024):
+                    if cancel and cancel.is_set(): raise ValueError('Download cancelled')
+                    total+=len(chunk)
+                    if total>256*1024*1024: raise ValueError('Image transfer exceeds 256 MiB')
+                    stream.write(chunk)
+                stream.flush(); os.fsync(stream.fileno())
+            os.replace(temp,path)
+        finally:
+            if os.path.exists(temp): os.unlink(temp)
+
+
+def sync_replica(root,client,cancel,progress):
+    """Push local outbox, then pull incremental changes; preserve drafts/conflicts."""
+    local=Project(root,create=False); conflicts=[]; changed=[]; sent=0
+    try:
+        meta=client.request('/meta')
+        if local.setting('remote_id') not in (None,meta['project_id']): raise ValueError('This cache belongs to a different team project')
+        local.set_setting('remote_id',meta['project_id']); local.set_setting('team_remote',client.url)
+        local.set_setting('tasks',meta['tasks']); local.set_setting('name',meta['name']); local.set_setting('reviewer',meta['reviewer'])
+        with local.conn:
+            for lab in meta['labels']:
+                local.conn.execute('INSERT OR REPLACE INTO labels VALUES(?,?)',(lab['name'],lab['color']))
+        for link in local.conn.execute('SELECT * FROM team_links WHERE dirty=1 AND conflict=0').fetchall():
+            if cancel.is_set(): break
+            ident=link['image_id']; row=local.image(ident)
+            payload={'revision':link['remote_revision'],'annotations':[a.to_dict() for a in local.load_annotations(ident)],'negative':row['status']=='empty'}
+            try: result=client.request(f'/state/{ident}',payload)
+            except ConflictError:
+                with local.conn: local.conn.execute('UPDATE team_links SET conflict=1 WHERE image_id=?',(ident,))
+                conflicts.append(ident); continue
+            with local.conn:
+                # A user may have edited again while the request was in flight.
+                current=[a.to_dict() for a in local.load_annotations(ident)]
+                same=current==payload['annotations'] and (local.image(ident)['status']=='empty')==payload['negative']
+                local.conn.execute('UPDATE team_links SET remote_revision=?,dirty=? WHERE image_id=?',(result['revision'],0 if same else 1,ident))
+            sent+=1
+        cursor=local.setting('remote_cursor',0)
+        while not cancel.is_set():
+            page=client.request('/changes?after='+str(cursor))
+            for remote in page['images']:
+                ident=remote['id']; link=local.conn.execute('SELECT * FROM team_links WHERE image_id=?',(ident,)).fetchone()
+                draft=local.conn.execute('SELECT 1 FROM drafts WHERE image_id=?',(ident,)).fetchone()
+                if link and (link['dirty'] or draft):
+                    if remote['revision']!=link['remote_revision']:
+                        conflicts.append(ident)
+                        with local.conn: local.conn.execute('UPDATE team_links SET conflict=1 WHERE image_id=?',(ident,))
+                    continue
+                if link and remote['revision']==link['remote_revision']: continue
+                state=client.request(f'/state/{ident}')
+                suffix=Path(remote['path']).suffix.lower()
+                if suffix not in ('.jpg','.jpeg','.png','.webp'): raise ValueError('Unsupported remote image extension')
+                ref=f'images/{ident:08d}_{Path(remote["path"]).name}'
+                if Path(ref).name!=ref.split('/')[-1] or '\\' in ref: raise ValueError('Unsafe remote filename')
+                annotations=[Annotation.from_dict(a) for a in state['annotations']]
+                errors=validate_all(annotations,{r['name'] for r in local.labels()},state['negative'])
+                if errors: raise ValueError('; '.join(errors))
+                with local.conn:
+                    local.conn.execute('BEGIN IMMEDIATE')
+                    latest=local.conn.execute('SELECT * FROM team_links WHERE image_id=?',(ident,)).fetchone()
+                    has_draft=local.conn.execute('SELECT 1 FROM drafts WHERE image_id=?',(ident,)).fetchone()
+                    if latest and (latest['dirty'] or has_draft):
+                        if state['revision']!=latest['remote_revision']:
+                            local.conn.execute('UPDATE team_links SET conflict=1 WHERE image_id=?',(ident,)); conflicts.append(ident)
+                        continue
+                    local.conn.execute('INSERT OR IGNORE INTO images(id,path,width,height,status) VALUES(?,?,?,?,?)',(ident,ref,remote['width'],remote['height'],state['status']))
+                    local.conn.execute('DELETE FROM annotations WHERE image_id=?',(ident,))
+                    local.conn.executemany('INSERT INTO annotations VALUES(?,?,?)',[(a.id,ident,json.dumps(a.to_dict())) for a in annotations])
+                    local.conn.execute('UPDATE images SET status=? WHERE id=?',(state['status'],ident))
+                    local.conn.execute('UPDATE revisions SET revision=revision+1 WHERE image_id=?',(ident,))
+                    local.conn.execute('INSERT OR REPLACE INTO team_links VALUES(?,?,0,0)',(ident,state['revision']))
+                changed.append(ident)
+            cursor=page['cursor']; local.set_setting('remote_cursor',cursor)
+            progress(len(changed),f'Synced {len(changed)} images · {sent} saves sent')
+            if not page['more']: break
+        conflicts.extend(row[0] for row in local.conn.execute('SELECT image_id FROM team_links WHERE conflict=1'))
+        return {'changed':changed,'conflicts':list(set(conflicts)),'sent':sent,'root':str(root),'meta':meta}
+    finally: local.close()
+
+
+def resolve_conflict(root,ident,client,keep_local):
+    local=Project(root,create=False)
+    try:
+        state=client.request(f'/state/{ident}')
+        if keep_local:
+            anns,negative,_=local.load_state(ident)
+            state=client.request(f'/state/{ident}',{'revision':state['revision'],'annotations':[a.to_dict() for a in anns],'negative':negative})
+        with local.conn:
+            local.conn.execute('DELETE FROM annotations WHERE image_id=?',(ident,))
+            local.conn.executemany('INSERT INTO annotations VALUES(?,?,?)',[(a['id'],ident,json.dumps(a)) for a in state['annotations']])
+            local.conn.execute('DELETE FROM drafts WHERE image_id=?',(ident,))
+            local.conn.execute('UPDATE images SET status=? WHERE id=?',(state['status'],ident))
+            local.conn.execute('UPDATE revisions SET revision=revision+1 WHERE image_id=?',(ident,))
+            local.conn.execute('UPDATE team_links SET remote_revision=?,dirty=0,conflict=0 WHERE image_id=?',(state['revision'],ident))
+        return ident
+    finally: local.close()

lannotex/theme.py

@@ -0,0 +1,58 @@
+from PySide6.QtGui import QColor, QPalette
+
+
+def apply_theme(app, dark=True):
+    bg, panel, raised = ('#141414','#1b1b1b','#292929') if dark else ('#fafafa','#ffffff','#f0f0f0')
+    text, muted, border = ('#eeeeee','#999999','#333333') if dark else ('#181818','#707070','#e3e3e3')
+    accent, on_accent = ('#eeeeee','#171717') if dark else ('#202020','#ffffff')
+    palette=QPalette()
+    for role,color in [(QPalette.Window,bg),(QPalette.WindowText,text),(QPalette.Base,panel),
+                       (QPalette.AlternateBase,raised),(QPalette.Text,text),(QPalette.Button,panel),
+                       (QPalette.ButtonText,text),(QPalette.Highlight,accent),(QPalette.HighlightedText,on_accent),
+                       (QPalette.ToolTipBase,panel),(QPalette.ToolTipText,text)]: palette.setColor(role,QColor(color))
+    app.setPalette(palette)
+    app.setStyleSheet(f'''
+        QWidget {{ font-size: 10pt; color: {text}; }}
+        QMainWindow, QDialog, QWidget#home, QWidget#workspace {{ background: {bg}; }}
+        QWidget#rail {{ background:{panel}; border-right:1px solid {border}; }}
+        QFrame#card {{ background:{panel}; border:1px solid {border}; border-radius:12px; }}
+        QLabel#hero {{ font-size:30pt; font-weight:600; letter-spacing:-1px; }}
+        QLabel#subtitle {{ font-size:12pt; color:{muted}; }}
+        QLabel#cardTitle {{ font-size:14pt; font-weight:600; }}
+        QPushButton#nav {{ text-align:left; padding:12px 16px; border:0; background:transparent; }}
+        QPushButton#nav:hover {{ background:{raised}; }}
+        QPushButton#pipeline {{ text-align:left; padding:0; border-radius:10px; min-height:112px; }}
+        QPushButton#pipeline:checked {{ border:2px solid {accent}; background:{raised}; color:{text}; }}
+        QFrame#header {{ background:{panel}; border-bottom:1px solid {border}; }}
+        QFrame#panel, QScrollArea {{ background:{panel}; border:1px solid {border}; border-radius:8px; }}
+        QLabel#brand {{ font-size:19pt; font-weight:700; }}
+        QLabel#section {{ color:{muted}; font-size:9pt; font-weight:600; padding-top:8px; }}
+        QLabel#muted {{ color:{muted}; }}
+        QLabel#save {{ color:{accent}; padding:6px 12px; background:{raised}; border-radius:6px; }}
+        QPushButton, QToolButton {{ background:{panel}; border:1px solid {border}; border-radius:5px; padding:7px 11px; }}
+        QPushButton:hover, QToolButton:hover {{ background:{raised}; border-color:{muted}; }}
+        QPushButton:pressed, QToolButton:checked {{ background:{raised}; border-color:{accent}; color:{accent}; }}
+        QPushButton#primary {{ background:{accent}; border-color:{accent}; color:{on_accent}; font-weight:600; }}
+        QPushButton#danger {{ color:{text}; }}
+        QPushButton:disabled, QToolButton:disabled {{ color:{muted}; border-color:{border}; }}
+        QLineEdit, QComboBox, QSpinBox, QDoubleSpinBox, QKeySequenceEdit {{ background:{bg}; border:1px solid {border}; border-radius:5px; padding:7px; selection-background-color:{accent}; }}
+        QLineEdit:focus, QComboBox:focus, QDoubleSpinBox:focus {{ border-color:{accent}; }}
+        QComboBox::drop-down {{ border:0; width:20px; }}
+        QListView, QListWidget, QTableWidget, QTextEdit {{ background:{panel}; border:0; outline:0; }}
+        QListView::item, QListWidget::item {{ border-bottom:1px solid {border}; padding:6px; }}
+        QListView::item:selected, QListWidget::item:selected {{ background:{raised}; color:{text}; border-left:3px solid {accent}; }}
+        QListView::item:hover {{ background:{raised}; }}
+        QSplitter::handle {{ background:{bg}; width:8px; }}
+        QMenuBar, QMenu {{ background:{panel}; }}
+        QMenuBar::item:selected, QMenu::item:selected {{ background:{raised}; }}
+        QMenu::item {{ padding:7px 26px; }}
+        QStatusBar {{ background:{panel}; border-top:1px solid {border}; }}
+        QStatusBar::item {{ border:0; }}
+        QScrollBar:vertical {{ background:{panel}; width:9px; margin:0; }}
+        QScrollBar::handle:vertical {{ background:{border}; min-height:30px; border-radius:4px; }}
+        QScrollBar::add-line:vertical, QScrollBar::sub-line:vertical {{ height:0; }}
+        QProgressBar {{ border:0; background:{raised}; border-radius:4px; text-align:center; }}
+        QProgressBar::chunk {{ background:{accent}; border-radius:4px; }}
+        QCheckBox {{ spacing:7px; padding:4px 0; }}
+        QToolTip {{ background:{panel}; color:{text}; border:1px solid {border}; padding:6px; }}
+    ''')

lannotex/workers.py

@@ -0,0 +1,124 @@
+"""Cancellable I/O jobs and serial, bounded background image decoding."""
+from collections import OrderedDict
+import os
+from pathlib import Path
+import threading
+import time
+from PIL import Image, ImageOps
+from PySide6.QtCore import QObject, QRunnable, QThreadPool, Signal, Slot
+from PySide6.QtGui import QImage
+from .storage import Project
+
+FORMATS = {'.jpg', '.jpeg', '.png', '.webp'}
+
+
+class Events(QObject):
+    result = Signal(object)
+    error = Signal(str)
+    progress = Signal(int, str)
+    finished = Signal()
+
+
+class Job(QRunnable):
+    def __init__(self, function):
+        super().__init__()
+        self.function = function
+        self.events = Events()
+        self.cancel = threading.Event()
+
+    def run(self):
+        try: self.events.result.emit(self.function(self.cancel, self.events.progress.emit))
+        except Exception as error: self.events.error.emit(str(error))
+        finally: self.events.finished.emit()
+
+
+def import_images(root, sources, cancel, progress):
+    project = Project(root, create=False)
+    added, found, damaged, batch = 0, 0, [], []
+    started = time.perf_counter()
+    def paths():
+        for source in sources:
+            source = Path(source)
+            if source.is_dir():
+                for folder, _, files in os.walk(source):
+                    if cancel.is_set(): return
+                    for name in files:
+                        if Path(name).suffix.lower() in FORMATS: yield Path(folder)/name
+            else: yield source
+    try:
+        for path in paths():
+            if cancel.is_set(): break
+            found += 1
+            try:
+                if path.suffix.lower() not in FORMATS: raise ValueError('Unsupported image format')
+                with Image.open(path) as im:
+                    width, height = im.size
+                    if im.getexif().get(274,1) in (5,6,7,8): width,height = height,width
+                # PNG EXIF lookup may consume the file; verify needs a fresh reader.
+                with Image.open(path) as im:
+                    im.verify()
+                batch.append((project.reference(path),width,height))
+            except Exception as error:
+                if len(damaged)<100: damaged.append(f'{path.name}: {error}')
+            if len(batch)>=128:
+                added += project.add_batch(batch); batch.clear()
+            if found%32==0: progress(found, f'Inspected {found:,} images · {added+len(batch):,} imported')
+        if batch: added += project.add_batch(batch)
+        return {'added':added,'scanned':found,'errors':damaged,'cancelled':cancel.is_set(),'seconds':time.perf_counter()-started}
+    finally: project.close()
+
+
+def decode(path):
+    # Display preview is capped; stored coordinates/dimensions remain full resolution.
+    with Image.open(path) as image:
+        image.draft('RGB',(2560,2560))
+        image = ImageOps.exif_transpose(image)
+        image.thumbnail((2560,2560),Image.Resampling.LANCZOS)
+        image = image.convert('RGBA')
+        data = image.tobytes()
+        return QImage(data,image.width,image.height,image.width*4,QImage.Format_RGBA8888).copy()
+
+
+class ImageLoader(QObject):
+    ready = Signal(object, object)
+    failed = Signal(object, str)
+
+    def __init__(self, parent=None, budget=96*1024*1024):
+        super().__init__(parent)
+        self.pool = QThreadPool(self); self.pool.setMaxThreadCount(1)
+        self.cache = OrderedDict(); self.bytes = 0; self.budget = budget
+        self.active = None; self.pending = None
+
+    def request(self, token, path):
+        path = str(path)
+        try: key = (path, Path(path).stat().st_mtime_ns)
+        except OSError as e: self.failed.emit(token,str(e)); return
+        if key in self.cache:
+            self.cache.move_to_end(key); self.ready.emit(token,self.cache[key]); return
+        if self.active:
+            self.pending = (token,path); return
+        job = Job(lambda cancel,progress: (token,key,decode(path)))
+        self.active = job
+        job.events.result.connect(self._loaded)
+        job.events.error.connect(self._error)
+        job.events.finished.connect(self._finished)
+        self.active_token = token
+        self.pool.start(job)
+
+    @Slot(object)
+    def _loaded(self, payload):
+        token,key,image = payload
+        size = image.sizeInBytes()
+        while self.cache and self.bytes+size > self.budget:
+            _, previous = self.cache.popitem(last=False); self.bytes -= previous.sizeInBytes()
+        if size <= self.budget: self.cache[key] = image; self.bytes += size
+        self.ready.emit(token,image)
+
+    @Slot(str)
+    def _error(self, error): self.failed.emit(self.active_token,error)
+
+    @Slot()
+    def _finished(self):
+        self.active = None
+        if self.pending:
+            token,path = self.pending; self.pending = None; self.request(token,path)

lannotex-0.1.0.dist-info/METADATA

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: lannotex
+Version: 0.1.0
+Summary: Fast, offline-first image annotation for classifications, boxes, and polygons.
+Author: Lourdhu Raju
+Maintainer: Lourdhu Raju
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Lourdhu02/Lannotex
+Project-URL: Source, https://github.com/Lourdhu02/Lannotex
+Project-URL: Issues, https://github.com/Lourdhu02/Lannotex/issues
+Project-URL: Documentation, https://lourdhu02.github.io/Lannotex/
+Project-URL: Changelog, https://github.com/Lourdhu02/Lannotex/blob/main/CHANGELOG.md
+Keywords: annotation,labeling,computer-vision,yolo,coco,labelme,qt,pyside6,machine-learning
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSES/THIRD_PARTY_NOTICES.md
+Requires-Dist: PySide6-Essentials<7,>=6.8.3
+Requires-Dist: Pillow>=11.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == "dev"
+Requires-Dist: pyinstaller>=6.11.1; extra == "dev"
+Requires-Dist: ruff>=0.11.2; extra == "dev"
+Requires-Dist: build>=1.2.2; extra == "dev"
+Requires-Dist: twine>=6.1; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/Lourdhu02/Lannotex/main/docs/assets/logo.svg" width="88" alt="Lannotex logo">
+
+# Lannotex
+
+**Fast, offline-first image annotation for bounding boxes, polygons, and image classes.**<br>
+Free and MIT-licensed. LabelMe-compatible. Your images never leave your machine.
+
+[![CI](https://img.shields.io/github/actions/workflow/status/Lourdhu02/Lannotex/ci.yml?branch=main&label=tests)](https://github.com/Lourdhu02/Lannotex/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/github/actions/workflow/status/Lourdhu02/Lannotex/docs.yml?branch=main&label=docs)](https://lourdhu02.github.io/Lannotex/)
+[![Python](https://img.shields.io/badge/python-3.11%20%E2%80%93%203.14-3776ab)](https://lourdhu02.github.io/Lannotex/getting-started/installation/)
+[![Platforms](https://img.shields.io/badge/Windows%20%C2%B7%20macOS%20%C2%B7%20Linux-supported-555)](https://github.com/Lourdhu02/Lannotex/releases)
+[![License: MIT](https://img.shields.io/github/license/Lourdhu02/Lannotex?color=37b8a5)](https://github.com/Lourdhu02/Lannotex/blob/main/LICENSE)
+
+[**Documentation**](https://lourdhu02.github.io/Lannotex/) ·
+[Quick start](https://lourdhu02.github.io/Lannotex/getting-started/quickstart/) ·
+[Coming from LabelMe](https://lourdhu02.github.io/Lannotex/migrate-from-labelme/) ·
+[Releases](https://github.com/Lourdhu02/Lannotex/releases)
+
+<img src="https://raw.githubusercontent.com/Lourdhu02/Lannotex/main/docs/assets/demo.gif" width="860" alt="Drawing two boxes and a polygon on a cat photo in Lannotex, then saving and moving to the next image">
+
+</div>
+
+## Why Lannotex?
+
+- **Everything you need is free.** YOLO, COCO, Labelme and CSV export, standalone desktop builds, and team review are all free and open source. No license keys, no Pro tier.
+- **Built for real datasets.** A project is one SQLite file instead of thousands of JSON files. The image list is virtualized, so its memory use stays flat; it was [benchmarked](https://lourdhu02.github.io/Lannotex/PERFORMANCE/) at 100,000 records. Your source images are never moved or modified.
+- **You can't lose work.** Every edit is written to a recovery draft, saves are transactional, and broken geometry (self-intersecting polygons, zero-size boxes) is rejected before it reaches your dataset.
+- **Private by default.** No account, no telemetry, no cloud. The app makes network requests only if you choose to host or join a team on your own network.
+
+## Install
+
+```bash
+uv tool install lannotex   # recommended, isolated install
+lannotex
+```
+
+<details>
+<summary>pip, pipx, standalone builds, and source</summary>
+
+```bash
+pipx install lannotex
+# or, inside a virtual environment
+python -m pip install lannotex
+```
+
+**Standalone builds** for Windows, macOS, and Linux are attached to every
+[release](https://github.com/Lourdhu02/Lannotex/releases). They bundle Python and Qt, so
+nothing else is needed.
+
+**From source:**
+
+```bash
+git clone https://github.com/Lourdhu02/Lannotex.git && cd Lannotex
+uv venv && uv pip install -e ".[dev]"
+lannotex
+```
+
+</details>
+
+Lannotex supports Python 3.11–3.14 on Windows, macOS, and Linux. See the
+[installation guide](https://lourdhu02.github.io/Lannotex/getting-started/installation/)
+for details.
+
+## Your first dataset in 60 seconds
+
+1. **Create a project** and pick a pipeline: *Classification*, *Object detection*, *Segmentation*, or *Combined*. Each one shows only the tools it needs.
+2. **Import a folder** (`Ctrl+I`). JPEG, PNG and WebP files are checked and referenced in place, not copied.
+3. **Add labels**, then draw: `B` for boxes, `P` for polygons (`Enter` finishes), `V` to select and edit.
+4. **Save & next** with `Ctrl+Enter`. Autosave and recovery drafts run in the background anyway.
+5. **Export** to the format your training code expects.
+
+Every shortcut can be remapped. See the [annotating guide](https://lourdhu02.github.io/Lannotex/guide/annotating/) for the full list.
+
+<table>
+  <tr>
+    <td><img src="https://raw.githubusercontent.com/Lourdhu02/Lannotex/main/docs/assets/workspace-light.png" alt="Lannotex workspace in light theme with a polygon and a box on a coffee cup"></td>
+    <td><img src="https://raw.githubusercontent.com/Lourdhu02/Lannotex/main/docs/assets/workspace-dark.png" alt="Lannotex workspace in dark theme with boxes on an astronaut photo"></td>
+  </tr>
+  <tr>
+    <td align="center">Light theme · polygon vertex editing</td>
+    <td align="center">Dark theme · object detection</td>
+  </tr>
+</table>
+
+## Features
+
+| | |
+| --- | --- |
+| **Annotate** | Bounding boxes · polygons with vertex drag, insert, and delete · multi-label image classes · "no target" negatives · 100-step undo/redo · zoom under the pointer, pan, arrow-key nudging · focus mode · light and dark themes |
+| **Stay safe** | SQLite projects with versioned migrations · recovery drafts and 700 ms autosave · transactional saves · geometry validation · backup and restore · relinking for moved images · EXIF orientation handled |
+| **Scale** | Virtualized image list (at most 1,024 records in memory) · background import and decoding · 96 MB preview cache · coordinates normalized to the original resolution |
+| **Export** | Labelme JSON · YOLO · COCO JSON · classification CSV · lossless native JSONL · each export reports anything it skipped |
+| **Automate** | `lannotex export` and `lannotex analyze` run headless in CI, with no display needed |
+| **Collaborate** | Optional LAN host with per-reviewer tokens, background sync, revision conflicts you resolve explicitly, revocation, and an audit history |
+
+## Lannotex vs. LabelMe
+
+LabelMe is a great tool and Lannotex reads and writes its JSON format, so you can switch
+without converting anything.
+
+| | Lannotex | LabelMe |
+| --- | :---: | :---: |
+| License | MIT | GPL-3.0 |
+| Standalone desktop app | Free | Paid license |
+| YOLO export | ✅ Free | Pro tier |
+| COCO export | ✅ | ✅ |
+| One database per dataset | ✅ | One JSON per image |
+| Crash recovery and transactional saves | ✅ | Optional autosave |
+| Team review with conflict handling | ✅ | — |
+| Headless export and validation CLI | ✅ | Example scripts |
+| AI-assisted annotation (SAM) | Not yet | ✅ |
+| Circles, lines, points, rotated boxes | Not yet | ✅ |
+
+Based on LabelMe's published features and pricing as of October 2026. The
+[full comparison and migration guide](https://lourdhu02.github.io/Lannotex/migrate-from-labelme/)
+covers which LabelMe shapes import today.
+
+## Command line
+
+```bash
+lannotex new ./dataset                                  # create a project
+lannotex analyze ./dataset                              # JSON health report: counts, problems, drafts
+lannotex export ./dataset ./out --format "COCO JSON"    # Labelme JSON | YOLO boxes | COCO JSON | Classification CSV | Native JSONL
+lannotex invite ./dataset "Alice"                       # print a one-time reviewer token
+lannotex host ./dataset --bind 0.0.0.0 --port 8765      # share a project on your LAN (TLS via --cert/--key)
+```
+
+`analyze` writes clean JSON to stdout, so it can gate a training pipeline. See the
+[CLI reference](https://lourdhu02.github.io/Lannotex/cli/).
+
+## Privacy
+
+Solo projects make no network requests. Team mode connects only to the host address you
+enter, reviewer tokens are kept in memory on clients, and the host stores only token
+hashes. There is no telemetry, no external AI service, and no automatic upload. Read the
+[team guide](https://lourdhu02.github.io/Lannotex/TEAM/) for LAN and TLS setup.
+
+## Roadmap
+
+Next up: a ready-to-train YOLO layout (`images/`, `labels/`, `data.yaml`), more LabelMe
+shape types, VOC and YOLO-seg export, and number-key label selection. See the
+[roadmap](https://lourdhu02.github.io/Lannotex/ROADMAP/) and the
+[measured performance](https://lourdhu02.github.io/Lannotex/PERFORMANCE/).
+
+## Contributing
+
+Bug reports, ideas, and pull requests are welcome. Start with
+[CONTRIBUTING.md](https://github.com/Lourdhu02/Lannotex/blob/main/CONTRIBUTING.md), and
+please follow the [Code of Conduct](https://github.com/Lourdhu02/Lannotex/blob/main/CODE_OF_CONDUCT.md).
+Report security issues privately, as described in
+[SECURITY.md](https://github.com/Lourdhu02/Lannotex/blob/main/SECURITY.md).
+
+If Lannotex saves you time, a ⭐ helps other people find it.
+
+## License
+
+[MIT](https://github.com/Lourdhu02/Lannotex/blob/main/LICENSE) © 2026 [Lourdhu Raju](https://github.com/Lourdhu02). Third-party licenses are
+listed in [THIRD_PARTY_NOTICES.md](https://github.com/Lourdhu02/Lannotex/blob/main/LICENSES/THIRD_PARTY_NOTICES.md).
+Demo images are public-domain and CC0 samples from
+[scikit-image](https://scikit-image.org/docs/stable/api/skimage.data.html).

lannotex-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+lannotex/__init__.py,sha256=rE4sApXHMrof1G9e-zPalhIsw8WNGm3nwFt9efOE85A,70
+lannotex/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
+lannotex/app.py,sha256=9tEYPryvJq_tQz59YZDVqCcRr9yWfZHSaUUOCP5fITo,64820
+lannotex/canvas.py,sha256=_c71kXqL5nCUMUPW8lCUJVJY7VVxvZ0zbbcFc3qDeTQ,12932
+lannotex/cli.py,sha256=jq6sY40FgyX_B-rW-go2y9RD6qSZMRZfrfC-mt9b_Ps,3890
+lannotex/domain.py,sha256=IMJs_bGkJmLinCwW8ZHXHlP9Z_xMc62nx4tlkj4i-7E,4601
+lannotex/exporters.py,sha256=IKsnsjujAge9m47YS9uIO05vmWajSOkwarjzKgxHprs,12743
+lannotex/home.py,sha256=wRD_UzcH7tAySo40ae630X72MNsciPyMy20GsrAjUf4,8731
+lannotex/models.py,sha256=izilkI9IAsZiaTiXZ7lOMKkU4ypeJdaTJ3VB-fR5FvE,2171
+lannotex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lannotex/storage.py,sha256=BuwT2deinlJUE291wCLCgIpopQqCQ8IuMTm9odwhSiM,14109
+lannotex/team.py,sha256=30v6wPM8y_ND-2cVqutMSVuGMgm6YJyLI1efHOGdCZQ,15556
+lannotex/theme.py,sha256=dUzo4RtOacA1CpPCvzjFISgmECHRmtMuqtIywuAD79o,4493
+lannotex/workers.py,sha256=aqXv0YybbC123akYRZqNSdPRDtX5Zu2oaEDwcmVFeUU,4816
+lannotex-0.1.0.dist-info/licenses/LICENSE,sha256=cmN7bFnVolJH65BS9k4xPmNpR_H_3XOkSKXsayDA1E4,1069
+lannotex-0.1.0.dist-info/licenses/LICENSES/THIRD_PARTY_NOTICES.md,sha256=Os0J5-rk7HRUOn_clXA-0X3_6plisaki-qsa1QxfXy8,844
+lannotex-0.1.0.dist-info/METADATA,sha256=GdtKc2cypBjBEMcofhGtWVc1gVl9W-a0Hp6aAxNql34,10574
+lannotex-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lannotex-0.1.0.dist-info/entry_points.txt,sha256=Agjj2djzQVRsVMe8v18VMtv0a0K2-5sZ5SLfu7IU6NE,80
+lannotex-0.1.0.dist-info/top_level.txt,sha256=fuT9X_GRL45AUvLwZOJgCvF1OSEDZ3tsLT83py0F-O4,9
+lannotex-0.1.0.dist-info/RECORD,,