conclave-personal 0.1.0__tar.gz

conclave_personal-0.1.0/LICENSE

@@ -0,0 +1,114 @@
+# PolyForm Noncommercial License 1.0.0
+
+https://polyformproject.org/licenses/noncommercial/1.0.0
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both
+strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything
+you might do with the software that would otherwise infringe the licensor's
+copyright in it for any permitted purpose. However, you may only distribute the
+software according to Distribution License and make changes or new works based
+on the software according to Changes and New Works License.
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of
+the software. Your license to distribute covers distributing the software with
+changes and new works permitted by Changes and New Works License.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms or the URL for them above, as well as
+copies of any plain-text lines beginning with `Required Notice:` that the
+licensor provided with the software. For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and
+new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent
+claims the licensor can license, or becomes able to license, that you would
+infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public
+knowledge, personal study, private entertainment, hobby projects, amateur
+pursuits, or religious observance, without any anticipated commercial
+application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research
+organization, public safety or health organization, environmental protection
+organization, or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do
+not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to
+anyone else, or prevent the licensor from granting licenses to anyone else.
+These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to
+infringement of any patent, your patent license for the software granted under
+these terms ends immediately. If your company makes such a claim, your patent
+license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these
+terms, or done anything with the software not covered by your licenses, your
+licenses can nonetheless continue if you come into full compliance with these
+terms, and take practical steps to correct past violations, within 32 days of
+receiving notice. Otherwise, all your licenses end immediately.
+
+## No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+## Definitions
+
+The licensor is the individual or entity offering these terms, and the software
+is the software the licensor makes available under these terms.
+
+You refers to the individual or entity agreeing to these terms.
+
+Your company is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+Control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+Your licenses are all the licenses granted to you for the software under these
+terms.
+
+Use means anything you do with the software requiring one of your licenses.
+
+© PolyForm Project Inc.

conclave_personal-0.1.0/MANIFEST.in

@@ -0,0 +1,23 @@
+include README.md
+include PROJECT.md
+include LICENSE
+include conclave-ui.html
+recursive-include static *.css *.js *.json
+recursive-include scripts/windows *.ps1
+recursive-include scripts/linux *
+recursive-include docs/assets/screenshots *.png
+include docs/index.md
+include docs/beispiel-workflows.md
+include docs/multi-agent-leitfaden.md
+include docs/personal-ui-architektur.md
+include docs/release-notes-v0.1.0.md
+include docs/sicherheit.md
+include docs/architektur/ports-adapter.md
+include docs/flows/api-request.md
+include docs/flows/orchestrierung.md
+include docs/flows/workspace-directives.md
+recursive-include docs/referenz *.md
+recursive-exclude workspace *
+recursive-exclude .claude *
+recursive-exclude tests __pycache__ *.pyc
+global-exclude __pycache__ *.py[cod] *.db *.db-shm *.db-wal *.key *.pem *.log

conclave_personal-0.1.0/PKG-INFO

@@ -0,0 +1,392 @@
+Metadata-Version: 2.4
+Name: conclave-personal
+Version: 0.1.0
+Summary: Local personal multi-agent workspace for Windows and Linux.
+License-Expression: LicenseRef-PolyForm-Noncommercial-1.0.0
+Keywords: multi-agent,llm,local-first,workspace,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Framework :: Flask
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=42.0
+Requires-Dist: flask>=3.0
+Requires-Dist: flask-limiter>=4.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40.0; extra == "anthropic"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == "openai"
+Provides-Extra: api
+Requires-Dist: flask>=3.0; extra == "api"
+Requires-Dist: flask-limiter>=4.0; extra == "api"
+Provides-Extra: crypto
+Requires-Dist: cryptography>=42.0; extra == "crypto"
+Provides-Extra: postgres
+Requires-Dist: psycopg2-binary>=2.9; extra == "postgres"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Requires-Dist: httpx>=0.27; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0; extra == "dev"
+Provides-Extra: dev-api
+Requires-Dist: pytest>=9.0; extra == "dev-api"
+Requires-Dist: flask>=3.0; extra == "dev-api"
+Provides-Extra: dev-all
+Requires-Dist: pytest>=9.0; extra == "dev-all"
+Requires-Dist: pytest-asyncio>=1.0; extra == "dev-all"
+Requires-Dist: flask>=3.0; extra == "dev-all"
+Requires-Dist: flask-limiter>=4.0; extra == "dev-all"
+Requires-Dist: anthropic>=0.40.0; extra == "dev-all"
+Requires-Dist: openai>=1.0; extra == "dev-all"
+Requires-Dist: cryptography>=42.0; extra == "dev-all"
+Requires-Dist: psycopg2-binary>=2.9; extra == "dev-all"
+Dynamic: license-file
+
+# Conclave Personal
+
+> Dieses Projekt wurde ausschließlich von LLM-Modellen erstellt.
+
+Conclave Personal ist ein lokales Multi-Agent-Arbeitswerkzeug für einzelne
+Nutzer. Es bringt mehrere KI-Modelle in eine gemeinsame, strukturierte
+Conversation, gibt ihnen explizite Rollen und macht ihre Zusammenarbeit über
+Runs nachvollziehbar.
+
+Der Nutzer bleibt die Steuerungsinstanz. Agenten sind Teilnehmer, keine
+Controller. Conversations, Workspace-Dateien, Agenten und Usage liegen
+standardmäßig lokal.
+
+> Status: v0.1.0 Alpha. Der Hauptpfad ist lokal, desktop-first und auf einzelne
+> Nutzer unter Windows und Linux ausgerichtet.
+
+![Conclave Studio](docs/assets/screenshots/conclave-studio-desktop.png)
+
+## Wofür Conclave da ist
+
+Conclave ist nicht einfach eine weitere Chat-UI. Der Kern ist:
+
+- Multiple models.
+- Explicit roles.
+- Structured collaboration.
+- Traceable runs.
+- Human control.
+- Local-first workspace.
+
+Praktisch heisst das:
+
+- Multi-Agent-Conversations mit Writer, Critic, Reviewer, Planner, Researcher
+  oder Judge führen.
+- Agenten als Participants in konkrete Conversations einladen.
+- Dateien aus einem lokalen Workspace gezielt als Kontext verwenden.
+- Modelle einzeln, parallel oder in Auto-Loops arbeiten lassen.
+- Judge-/Review-Läufe für gegenseitige Prüfung nutzen.
+- Runs, Token-Usage, Fehler und Ergebnisse nachvollziehen.
+- Unter Windows und Linux lokal arbeiten.
+
+## 60-Sekunden-Beispiel
+
+```text
+        ┌→ Writer
+Prompt ─┼→ Critic ─→ Judge
+        └→ Researcher
+```
+
+1. Conversation erstellen.
+2. Agents als Participants hinzufügen.
+3. Rollen vergeben: Writer entwirft, Critic widerspricht, Judge bewertet.
+4. Prompt senden.
+5. Run beobachten.
+6. Ergebnisse vergleichen und die nächste Runde bewusst starten.
+
+Minimaler CLI-Flow:
+
+```bash
+conclave desktop
+conclave agent-new writer --name "Writer" --provider "openai-responses" --preset "openai-responses" --model "<openai-model>" --role "Writer" --api-key "..."
+conclave agent-new judge --name "Judge" --provider "ollama" --preset "ollama" --model "llama3.1" --role "Judge"
+CONV=$(conclave --json new | python -c "import sys,json; print(json.load(sys.stdin)['conversation_id'])")
+conclave add-participant "$CONV" writer --name "Writer" --type model
+conclave add-participant "$CONV" judge --name "Judge" --type model
+conclave message "$CONV" "Entwirf eine knappe Produktpositionierung und lass sie prüfen."
+conclave invoke "$CONV" writer
+conclave invoke "$CONV" judge
+conclave runs "$CONV"
+```
+
+## Produktbereiche
+
+| Bereich | Zweck |
+| --- | --- |
+| Studio | Conversations, Messages, Participants, Floor, Invoke, Stream, Orchestrierung, Auto-Loop |
+| Agents | Agenten, Rollen, Provider, Modelle, Presets, Verbindungstests |
+| Workspace | Lokale Dateien, Kontext, Notizen, Outputs |
+| Runs | Invoke-, Judge-, Auto-Loop- und Orchestrierungsverlauf, Usage, Fehler |
+| Settings | API-Keys, Datenpfade, Theme, Backup, lokaler Sicherheitsmodus |
+
+## Nicht-Ziele
+
+- Keine DSGVO-/Enterprise-Plattform.
+- Kein Consent-Management pro Provider.
+- Keine DPA-/AV-Vertragsverwaltung.
+- Keine rollenbasierte Unternehmensadministration.
+- Kein Docker-Zwang für Endnutzer.
+
+## Plattformziel
+
+Conclave Personal unterstützt Windows und Linux. Die CI-Matrix prüft Ubuntu
+und Windows mit Python 3.11 und 3.12.
+
+Der Anwendungskern bleibt plattformneutral. Betriebssystem-spezifisch sind nur
+Start-, Installations- und Autostart-Adapter:
+
+- Windows: Desktop-Start, optional User-Autostart oder NSSM-Service.
+- Linux: Desktop-Start, optional `systemd --user` und `.desktop` Datei.
+- Docker ist nicht Teil des v0.1.0-Endnutzerpfads.
+
+## Installation
+
+Nach der PyPI-Veröffentlichung ist der Zielpfad:
+
+### Windows
+
+```powershell
+pipx install conclave-personal
+conclave desktop
+```
+
+### Linux
+
+```bash
+pipx install conclave-personal
+conclave desktop
+```
+
+Vor der PyPI-Veröffentlichung wird aus dem gebauten Wheel getestet:
+
+```bash
+python -m build --sdist --wheel
+python -m venv .venv-smoke
+.venv-smoke/Scripts/pip install dist/conclave_personal-0.1.0-py3-none-any.whl
+.venv-smoke/Scripts/conclave --help
+```
+
+Unter Linux entsprechend mit `.venv-smoke/bin/...`.
+
+### Aus Einem Checkout
+
+```bash
+python -m pip install -e ".[dev-all]"
+conclave desktop
+```
+
+Tests für Entwicklung:
+
+```text
+python -m pytest
+```
+
+Bestehende lokale SQLite-Daten kannst du explizit migrieren:
+
+```bash
+conclave migrate-personal --from /pfad/zur/alten/conclave.db --dry-run
+conclave migrate-personal --from /pfad/zur/alten/conclave.db
+```
+
+## Provider Einrichten
+
+Lege Agents mit Provider, Modell und optionaler Rolle an:
+
+```bash
+conclave agent-new reviewer \
+  --name "Reviewer" \
+  --provider "anthropic" \
+  --preset "anthropic" \
+  --model "<anthropic-model>" \
+  --role "Reviewer" \
+  --api-key "..."
+```
+
+Ollama kann lokal ohne API-Key laufen:
+
+```bash
+conclave agent-new local-judge \
+  --name "Local Judge" \
+  --provider "ollama" \
+  --preset "ollama" \
+  --model "llama3.1" \
+  --role "Judge"
+```
+
+Einen reproduzierbaren End-to-End-Test mit Claude, Gemini und GPT beschreibt
+der [Provider-Smoke-Test](docs/provider-smoke-test.md).
+
+## Lokaler Schnellstart
+
+Der empfohlene Personal-CLI-Pfad ist:
+
+```bash
+conclave desktop
+```
+
+Technische Modi:
+
+```bash
+conclave server
+conclave web
+```
+
+oder für direkte CLI-Flows:
+
+```bash
+conclave agent-new assistant \
+  --name "Assistant" \
+  --provider "openai-responses" \
+  --preset "openai-responses" \
+  --model "<openai-model>" \
+  --api-key "..."
+
+ID=$(conclave --json new | python -c "import sys,json; print(json.load(sys.stdin)['conversation_id'])")
+conclave add-participant "$ID" assistant --name "Assistant" --type model
+conclave message "$ID" "Analysiere diese Idee aus drei Perspektiven."
+conclave invoke "$ID" assistant
+```
+
+Auto-Loop und Judge-Workflows sind in den
+[Beispiel-Workflows](docs/beispiel-workflows.md) beschrieben.
+
+## Kernkonzepte
+
+### Conversation
+
+Ein lokaler Arbeitsraum mit Thema, Nachrichten, Regeln und Participants.
+
+### Agent
+
+Eine wiederverwendbare Provider-/Modell-/Rollen-Konfiguration.
+
+### Participant
+
+Ein Agent innerhalb einer konkreten Conversation.
+
+### Workspace
+
+Ein lokaler Ordner für Dateien, Notizen, Kontext und Outputs. Dateien werden
+nicht automatisch als Kontext geladen. Der Nutzer referenziert sie explizit,
+zum Beispiel mit `@workspace/notizen.md`.
+
+### Run
+
+Ein ausführbarer Arbeitslauf: Invoke, Stream, Orchestrierung, Auto-Loop oder
+Judge. Runs machen Status, Fehler, Dauer und Usage sichtbar.
+
+## Zielarchitektur
+
+```text
+src/conclave/
+  domain/          reine Fachmodelle
+  application/     Services, Orchestrierung, Ports
+  infrastructure/  Provider, Datenbanken, Crypto, Runtime-Adapter
+  api/             lokale HTTP-API
+  cli/             Kommandozeile
+  runtime/         plattformneutrale Desktop-/Server-Startlogik
+
+static/
+  js/core/         API, State, Router, Events
+  js/features/     Studio, Agents, Workspace, Runs, Settings
+```
+
+## Provider
+
+Conclave bleibt provideragnostisch. v0.1.0 unterscheidet bewusst zwischen
+getesteten Hauptpfaden und kompatiblen Presets.
+
+### First-class / getestet
+
+Diese Pfade sind durch lokale Tests, API-Verträge oder konkrete Adaptertests
+abgesichert:
+
+- OpenAI Responses
+- OpenAI Chat Completions
+- Anthropic
+- Ollama
+
+### Built-in preset / kompatibel / experimentell
+
+Diese Presets sind eingebaut, können aber je nach Provider-API, Modell und
+Account variieren:
+
+- Gemini
+- Mistral
+- DeepSeek
+- Qwen / DashScope
+- Custom/OpenAI-compatible Endpoints
+
+API-Keys bleiben lokal gespeichert und werden bei Agenten verschlüsselt in der
+lokalen Datenbank abgelegt. Ollama kann ohne API-Key funktionieren.
+
+## Local-first, Nicht Offline-only
+
+Conclave speichert Workspace, Konfiguration, Agenten, Conversations und
+Run-Historie lokal. Wenn ein Remote-Provider wie OpenAI, Anthropic, Gemini,
+Mistral, DeepSeek oder DashScope genutzt wird, werden die für den jeweiligen
+Modellaufruf erforderlichen Prompt-/Kontextdaten an diesen Provider
+übertragen. Bei Ollama oder lokalen kompatiblen Endpunkten kann die
+Verarbeitung vollständig lokal erfolgen.
+
+## Sicherheit
+
+Conclave bindet die lokale API standardmäßig an `127.0.0.1`. Für den
+`production`-Modus muss ein lokaler API-Key gesetzt sein. Workspace-Zugriffe
+bleiben im konfigurierten Workspace-Root und versteckte Pfade werden nicht als
+Agent-Kontext gelesen.
+
+Mehr Details: [Sicherheit für Conclave Personal](docs/sicherheit.md).
+
+## Dokumentation
+
+Wichtige Dokumente:
+
+- [Multi-Agent-Leitfaden](docs/multi-agent-leitfaden.md)
+- [Beispiel-Workflows](docs/beispiel-workflows.md)
+- [Sicherheit](docs/sicherheit.md)
+- [Konfiguration](docs/referenz/konfiguration.md)
+- [Release Notes v0.1.0](docs/release-notes-v0.1.0.md)
+- [Dokumentationsindex](docs/index.md)
+
+## Known Limitations
+
+v0.1.0 bleibt bewusst Alpha. Bekannte Einschränkungen:
+
+- Backup-Erstellung ist vorhanden; Restore validiert aktuell nur und schreibt
+  noch keine Daten zurück.
+- Provider-Kompatibilität variiert nach API, Modell, Account und Region.
+- Remote-Provider erhalten die für den Modellaufruf benötigten Daten.
+- Desktop-Modus startet die lokale Web-Anwendung im Browser.
+- Erweiterte Multi-Agent-Orchestrierung ist in Teilen experimentell.
+- Es gibt noch keinen nativen Windows-Installer, kein AppImage und kein `.deb`.
+
+## Release-Verifikation
+
+Der v0.1.0-Schnitt wird vor Veröffentlichung mit diesen lokalen Checks
+verifiziert:
+
+- `python -m pytest`
+- `python -m build --sdist --wheel`
+- Installation aus dem gebauten Wheel in einer frischen Umgebung.
+- `conclave --help`
+- `conclave desktop`
+- Artefaktprüfung ohne Workspace-Daten, Datenbanken, Keys, Logs und alte
+  Enterprise-/DSGVO-Pfade.
+
+## Lizenz
+
+PolyForm Noncommercial License 1.0.0. Siehe [LICENSE](LICENSE).
+
+Free for noncommercial use. Commercial use requires a separate license.
+Commercial licensing: coming soon.

conclave_personal-0.1.0/PROJECT.md

@@ -0,0 +1,83 @@
+# Conclave Personal
+
+**Projekt-ID:** `conclave`
+**Arbeitsbranch:** `personal-multiplatform`
+**Phase:** Phase 13 - Release-Vorbereitung
+
+## Ziel
+
+Conclave Personal ist ein lokales, multiplattformfähiges
+Multi-Agent-Arbeitswerkzeug für einzelne Nutzer.
+
+Der Nutzer führt Conversations, lädt Agenten mit unterschiedlichen Rollen ein,
+stellt Workspace-Dateien als Kontext bereit und startet strukturierte Läufe wie
+Invoke, Parallel-Orchestrierung, Auto-Loop und Judge/Review.
+
+Windows und Linux sind gleichwertige Zielplattformen. Docker bleibt optional,
+ist aber nicht der primäre Nutzerpfad.
+
+## Zielgruppe
+
+- Einzelne Entwickler, Autoren, Analysten und Wissensarbeiter.
+- Nutzer, die mehrere KI-Modelle oder Rollen bewusst koordinieren wollen.
+- Nutzer, die lokale Datenhaltung und transparente Provider-Konfiguration
+  bevorzugen.
+
+## Kernflows
+
+1. Agenten anlegen und Provider testen.
+2. Conversation starten und Participants einladen.
+3. Workspace-Dateien als Kontext referenzieren.
+4. Agenten einzeln, parallel oder im Auto-Loop arbeiten lassen.
+5. Judge-Agent für Review oder Chain-of-Verification nutzen.
+6. Runs, Usage und Ergebnisse nachvollziehen.
+7. Lokale Daten sichern und Backup-Archive validieren.
+
+## Produktbereiche
+
+- **Studio:** aktive Conversations, Messages, Floor, Invoke, Stream,
+  Orchestrierung und Auto-Loop.
+- **Agents:** Agenten, Rollen, Provider, Modelle, Presets und Tests.
+- **Workspace:** lokale Dateien, Kontext, Notizen und Agent-Outputs.
+- **Runs:** Laufhistorie, Judge-Ergebnisse, Fehler, Dauer und Usage.
+- **Settings:** API-Keys, Datenpfade, Theme, Backup, lokaler Sicherheitsmodus.
+
+## Nicht-Ziele
+
+- Keine DSGVO-/Enterprise-Plattform.
+- Kein Consent-Management pro Provider.
+- Keine DPA-/AV-Vertragsverwaltung.
+- Keine rollenbasierte Unternehmensadministration.
+- Kein serverzentriertes Teamprodukt als Hauptfall.
+- Kein Docker-Zwang für Endnutzer.
+
+## Architekturprinzipien
+
+- Der Nutzer ist die Steuerungsinstanz.
+- Agenten sind Teilnehmer, keine Controller.
+- Daten liegen standardmäßig lokal.
+- Provider bleiben austauschbar.
+- Der Core ist plattformneutral.
+- Windows- und Linux-Integration sind Runtime-Adapter, nicht Produktkern.
+- Workspace-Zugriffe bleiben explizit und begrenzt.
+- Kosten und Läufe bleiben sichtbar.
+
+## Aktueller Stand
+
+Der Personal-Pfad ist lokal, desktop-first und auf einzelne Nutzer
+ausgerichtet. Der aktuelle Release-Schnitt ist installierbar, CI-abgesichert
+und mit Lizenz, Release Notes, Security-Hinweisen, Beispiel-Workflows,
+Screenshots sowie expliziter SQLite-Migration veröffentlichungsnah
+vorbereitet.
+
+## Regeln
+
+Dieses Repository ist für v0.1.0 selbstbeschreibend. Für Beiträge gelten:
+
+- Personal-first: keine Enterprise-/DSGVO-Oberflächen wieder einführen.
+- Keine Feature-Ausweitung während Release-Stabilisierung ohne konkreten
+  Fehler- oder Release-Grund.
+- Runtime-Pfade müssen Windows und Linux/XDG respektieren.
+- Workspace-Zugriffe bleiben explizit, begrenzt und pfadgeschützt.
+- Remote-Provider dürfen nicht als offline oder lokal dargestellt werden.
+- Tests, Packaging und relevante Dokumentation gehören zur Definition of Done.