Installation¶
Prerequisites¶
Before starting, ensure you have:
-
Python 3.13 or higher
ArchiPy requires Python 3.13+. Check your version with:
If needed, download Python 3.13+.
-
Poetry (for dependency management)
Poetry manages dependencies and project setup. Install it via the official guide.
Installation Methods¶
Using pip¶
Install the core library:
With optional dependencies (e.g., Redis, FastAPI):
Using Poetry¶
Add the core library:
With optional dependencies:
Optional Dependencies¶
ArchiPy supports modular features:
Feature | Installation Command |
---|---|
Redis | archipy[redis] |
FastAPI | archipy[fastapi] |
JWT | archipy[jwt] |
Kavenegar | archipy[kavenegar] |
Prometheus | archipy[prometheus] |
Sentry | archipy[sentry] |
Dependency Injection | archipy[dependency-injection] |
Scheduler | archipy[scheduler] |
gRPC | archipy[grpc] |
PostgreSQL | archipy[postgres] |
FakeRedis | archipy[fakeredis] |
Full list | See Usage section |
Development Installation¶
For contributors:
# Clone the repository
git clone https://github.com/SyntaxArc/ArchiPy.git
cd ArchiPy
# Set up the project
make setup
# Install dependencies
make install
# Optional: Install dev tools
make install-dev
Troubleshooting¶
If issues arise, verify:
- Python version is 3.13+
pip
orpoetry
is updated (e.g.,pip install --upgrade pip
)- Build tools (
setuptools
,wheel
) are installed
IDE Integration
For the best development experience, use an IDE that supports Python type hints, such as PyCharm or VS Code with the Python extension.