Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arkitektio/arkitekt
arkitekt is the python api client for the arkitekt-framework
https://github.com/arkitektio/arkitekt
arkitekt
Last synced: 19 days ago
JSON representation
arkitekt is the python api client for the arkitekt-framework
- Host: GitHub
- URL: https://github.com/arkitektio/arkitekt
- Owner: arkitektio
- License: mit
- Created: 2021-09-15T13:01:09.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-07-05T15:17:37.000Z (6 months ago)
- Last Synced: 2024-07-05T20:21:59.009Z (6 months ago)
- Topics: arkitekt
- Language: Python
- Homepage: https://arkitekt.live
- Size: 3.64 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# arkitekt
[](https://codecov.io/gh/jhnnsrs/arkitekt)
[](https://pypi.org/project/arkitekt/)
[](https://pypi.org/project/arkitekt/)
[](https://pypi.python.org/pypi/arkitekt/)
[](https://pypi.python.org/pypi/arkitekt/)
streaming analysis for mikroscopy
## Idea
arkitekt is the python client for the arkitekt platform. It allows you to utilize the full extent of the platform from your python code.
To understand the idea behind arkitekt, you need to understand the idea behind the arkitekt platform.
(More on this in the [documentation](https://arkitekt.live))
## Features
- Host your python functions and make them to your team
- Use functions from your team in your code
- Interact with and store data in a secure and scalable way on the platform
- Use the platform as a central storage for your data
## Install
```bash
pip install arkitekt[all]
```
This installs all dependencies for the arkitekt platform, inlcuding the arkitekt CLI, which can be used to develop and create apps, containerize them and deploy t
arkitekt is relying heavily on asyncio patters and therfore supports python 3.8 and above. It also relies on the pydantic stack for serialization.
## App
You can use the cli to create python based apps for the arkitekt platform, profiting from a battery of features like easy GUI creation based on
type annotations, orchestration of real-time (in memoery) workflows, data hosting, easy packaging and distribution in docker containers, etc...
To get started create a directory and run
```bash
arkitekt init
```
Which will lead you throught an app creation process.
Apps can simply registered functions, through the register decorator
```python
from arkitekt import register
@register()
def rpc_function(x: int, name: str) -> str
"""
A rpc function that we can
simple call from anywhere
""
```
And then connected to a local or remote server by running
Run example:
```bash
arkitekt run dev
```
For more details on how to create an app follow the tutorials on https://arkitekt.live.
## Usage with complex Datastructures
Arkitekt takes care of serialization and documentation of standard python datastructures
- str
- bool
- int
- float
- Enum
- Dict
- List
To increase performance and reduce latency it is not possible to serialize complex python objects like numpy arrays into the messages. These are best transformed into immutable objects on a centrally accessible storage and then only the reference is passed.
Arkitekt does not impose any rules on how you handle this storage (see mikro for ideas), it provides however a simple api.
```python
class ComplexStructure:
id: str # A reference for this structure on central storage
async def shrink(self):
return self.id
@classmethod
async def expand(cls, value):
return cls.load_from_server(value)
```
by providing two functions:
- shrink
- expand
You can now use this Structure with simple typehints and arkitekt will automaticall shrink (serialize) and expand (deserialize) the structure on calling.
```python
def complex_call(x: ComplexStrucuture) -> int:
return x.max()
```
Check out the arkitekt [documentation](https://arkitekt.live) for usage of this libary