Arete
Pro-grade synchronization from Obsidian to Anki.
arete is a robust, fast, and feature-rich tool that adheres to a strict One-Way Sync philosophy: Obsidian is the Source of Truth. It allows you to maintain complex study materials in your vault while keeping Anki perfectly in sync.
🚀 Key Features
- ⚡ Turbocharged Sync: SQLite caching skips unchanged files for near-instant updates.
- 📐 Topological Sort: Build filtered study queues that respect prerequisite dependencies.
- 🧬 FSRS Support: Native difficulty and retention analysis for modern memory schedulers.
- 🧹 Orphan Management: Automatically prunes deleted cards from your Anki collection.
- 🩹 Self-Healing: Automatically repairs duplicate IDs or broken internal references.
- 📸 Rich Media: Full synchronization of images, SVGs, and other attachments.
- 💻 Cross-Platform: First-class support for macOS, Linux, and Windows (including WSL).
📦 Quick Start
1. Install CLI
arete requires uv for high-performance dependency management.
git clone https://github.com/Adanato/Arete
cd obsidian_2_anki
uv sync
# To enable Agentic features (v3 preview):
# uv sync --extra agent
2. Install Plugin
Download the latest release from the Releases page and place the files in your plugin folder:
.obsidian/plugins/arete/
3. Initialize & Sync
uv run arete init # Interactive setup wizard
uv run arete sync # Your first sync
📚 Documentation
- CLI Guide: Command-line options, configuration, and syntax.
- Obsidian Plugin Guide: How to use the GUI and Gutter features.
- Architecture: Technical deep-dive into the core logic.
- Troubleshooting: Common fixes for WSL and networking.
🔄 Upgrading to v2.0
Upgrading from a legacy version? arete includes a migration tool to normalize your metadata:
uv run arete migrate
📄 License
MIT
1 maintainer
Metadata
1 maintainer
Release files for arete 2.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| arete-2.0.1.tar.gz | 412.8 kB | With provenance | Details for arete-2.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| arete-2.0.1-py3-none-any.whl | Python 3 | none | any | Details for arete-2.0.1-py3-none-any.whl |
Total release size: 519.8 kB
Release files / arete-2.0.1.tar.gz
| Download URL | arete-2.0.1.tar.gz |
|---|---|
| Size | 412.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
acf39b97d3dafc4b541005ce2bb209e83a21602eb5cd4e838eb8cf6b354dba67
|
|
BLAKE2b-256 checksum How to use checksums |
7870478aee6717b3c555d5965fb39c452ccd81a47b90fcbbb940298ce67424dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 19, 2026.
Transparency logRelease files / arete-2.0.1-py3-none-any.whl
| Download URL | arete-2.0.1-py3-none-any.whl |
|---|---|
| Size | 106.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7a89d289e3bc159a0975bba42e7981b4953a0d9afa945170e23f72580d9096a0
|
|
BLAKE2b-256 checksum How to use checksums |
13eadd3ff94caf3a1eeccd482f6201a8851fe5cb537e6ff5a72831712e3f3c81
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 19, 2026.
Transparency logSecurity for arete 2.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for arete-2.0.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 19, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
