PyArchInit-Mini Logo

PyArchInit-Mini Documentation

PyPI version Python versions License Documentation Status

Lightweight Archaeological Data Management System

PyArchInit-Mini is a standalone, modular version of PyArchInit focused on core archaeological data management functionality without GIS dependencies. It provides multiple interfaces (Web, Desktop GUI, CLI, REST API) with a clean, scalable architecture for managing archaeological sites, stratigraphic units, and material inventories.

Key Features

  • Multi-Interface Support: Web, Desktop GUI, CLI, and REST API

  • Multi-Database: SQLite and PostgreSQL support

  • Internationalization: Full Italian and English language support

  • Harris Matrix: Graphviz visualization with GraphML export

  • Extended Matrix Framework: 14 specialized unit types with custom workflows

  • 3D Visualization: s3Dgraphy integration for stratigraphic units

  • Multi-User Authentication: Role-based access control

  • Real-Time Collaboration: WebSocket support for team updates

  • Analytics Dashboard: Interactive charts and data visualization

  • Python API: Complete programmatic access for custom integrations

What’s New

Version 1.9.23 - MCP Tools Expansion & AI Integration

Added in version 1.9.23: MCP (Model Context Protocol) Integration:

  • ✨ 23 MCP Tools for Claude Desktop & ChatGPT integration (expanded from 5)

  • ✨ 6 Tool Categories: Data Management (8), Validation (3), Harris Matrix & 3D (4), Reports & Export (2), Media & Thesaurus (2), System (4)

  • ✨ Advanced Validation: Stratigraphic relationship validation with cycle detection

  • ✨ Media Management: 7 operations (list, upload, download, delete, get_info, search, update_metadata)

  • ✨ Thesaurus Management: 8 operations (list, get_values, add/update/delete, search, import/export)

  • ✨ 5 Resources: GraphML, US, Periods, Relationships, Sites

  • ✨ 3 Prompts: Stratigraphic Model, Period Visualization, US Description

See PyArchInit MCP Integration Guide for complete AI integration guide.

Version 1.8.5 - Database Creation & Chronological Management

Added in version 1.7.0: Database Creation Features:

  • ✨ Empty database creation (SQLite/PostgreSQL) with complete schema

  • ✨ Multi-interface support (CLI, Python API, Web GUI)

  • ✨ Automatic dating synchronization from US values

  • ✨ Periodization records viewer with advanced search

See Database Creation and Management for complete documentation.

Version 1.8.5 - Extended Matrix & GraphML Export

Added in version 1.6.0:

  • ✨ Extensible EM node type system (YAML configuration)

  • ✨ Pure NetworkX GraphML export (no Graphviz dependency)

  • ✨ 14 built-in node types with custom extension support

See Extended Matrix Framework - Complete Guide and Extended Matrix GraphML Export - Technical Guide.

Getting Started

New to PyArchInit-Mini? Start here for installation and basic setup.

Installation & Setup

Tutorials

Step-by-step tutorials with screenshots to get you started quickly.

Interactive Tutorials

User Guides

Complete guides for using PyArchInit-Mini interfaces and features.

Interface Guides

Core Features

In-depth documentation for PyArchInit-Mini’s main features.

Database Management

Data Management

Harris Matrix & Visualization

AI Integration & 3D Visualization

Import/Export & Integration

User Management & Analytics

Python API & Integration

Complete Python API documentation with integration examples for external projects.

Python API

Examples & Tutorials

Practical examples and step-by-step tutorials.

Code Examples

Reference

Technical reference and API documentation.

Development

Contributing, testing, and development documentation.