Anytype Python Client

A Python client for interacting with Anytype. Automate workflows and integrate with your apps! ✨

🚀 Features

• Seamless Integration: Connect Python scripts directly to your Anytype workspace.
• Object Management: Create, modify, and organize pages, notes, and custom objects.
• Space Operations: Manage spaces, types, and relations programmatically.
• Batch Operations: Export data, automate repetitive tasks, and more.
• PDF Import Example: Bulk import annotated PDFs as structured notes (see examples).

📦 Installation

pip install anytype-client

Prerequisites:

• Python 3.10+
• Anytype desktop app (v0.44.13-beta or higher) running during authentication

⚡ Quick Start

1. Authentication

from anytype import Anytype

# Initialize client (first run triggers authentication)
any = Anytype()
any.auth()  # 🔑 Enter 4-digit code from Anytype app when prompted

2. Create Your First Object

from anytype import Object

# Get your workspace
spaces = any.get_spaces()
my_space = spaces[0]  # Use your preferred space

# Create a new page
note_type = my_space.get_type("Page")
new_note = Object()
new_note.name = "My Python-Powered Note 📝"
new_note.icon = "🔥"
new_note.description = "Automatically generated via Python API"

# Add rich content
new_note.add_title1("Welcome to Automated Knowledge Management!")
new_note.add_text("This section was created programmatically using Python")

# Commit to workspace
created_object = my_space.create_object(new_note, note_type)
print(f"Created object: {created_object.name}")

API 2025-11-08

List endpoints accept the API's dynamic filter syntax as a dictionary, global search accepts the complete search body, and spaces expose chat listing and file upload:

spaces = any.get_spaces(filters={"name[contains]": "project"})
pages = any.global_search(
    "roadmap",
    types=["page", "task"],
    sort={"direction": "desc", "property_key": "last_modified_date"},
)

chats = spaces[0].get_chats(limit=50)
uploaded = spaces[0].upload_file("./report.pdf")
objects = spaces[0].get_objects(
    filters={"type": "page", "created_date[gte]": "2024-01-01"}
)

🌟 Examples

📄 Documentation

Check the documentation here!

🤝 Contributing

Contributions are welcomed! Here's how to help:

1. Report bugs or request features via Issues
2. Submit pull requests for improvements
3. Share your use cases in Discussions

📄 License

GPL-3.0 License - see LICENSE for details.