Each device feature is its own pip package, with full reference docs. Install what you need, list it in modules, and nothing else gets compiled into your app.
pyxpo[tool.pyxpo]
modules = ["image-picker"]res = await ImagePicker.launchImageLibraryAsync()pyxpo-storageFast key-value storage for settings and small app data, with hooks that re-render on change.
"storage"from pyxpo_storage import storage, use_storage_stringstorage.setstorage.get_stringuse_storage_stringStorage(id=...)pyxpo-secure-storeKeep tokens and secrets encrypted in the iOS Keychain and Android Keystore, with optional biometrics.
"secure-store"import pyxpo_secure_store as SecureStoreSecureStore.set_item_asyncSecureStore.get_item_asyncSecureStore.delete_item_asyncpyxpo-file-systemRead, write, copy and download files in the app's document and cache folders.
"file-system"from pyxpo_file_system import File, Directory, PathsFile(...).writeFile(...).text_syncDirectory.listFile.download_file_asyncpyxpo-sqliteReal SQLite databases with expo-sqlite's API: dict rows, transactions, prepared statements and a provider.
"sqlite"import pyxpo_sqlite as SQLiteopen_database_asyncrun_asyncget_all_asyncwith_transaction_asyncSQLiteProviderpyxpo-image-pickerPick photos and videos from the library, or take new ones with the camera.
"image-picker"from pyxpo_image_picker import ImagePickerImagePicker.launchImageLibraryAsyncImagePicker.launchCameraAsyncpyxpo-image-manipulatorResize, crop, rotate, flip, compress and convert images on the device.
"image-manipulator"from pyxpo_image_manipulator import ImageManipulator, SaveFormat, FlipTypeImageManipulator.manipulateAsyncImageManipulator.compressToSizeAsyncImageManipulator.getInfoAsyncpyxpo-media-librarySave photos and videos to the device gallery, with permission helpers.
"media-library"from pyxpo_media_library import MediaLibraryMediaLibrary.saveToLibraryAsyncMediaLibrary.createAssetAsyncMediaLibrary.requestPermissionsAsyncpyxpo-cameraA CameraView component for photos, videos and live barcode and QR scanning.
"camera"import pyxpo_camera as CameraCameraViewtake_picture_asyncrecord_asyncuse_camera_permissionsscan_from_url_asyncpyxpo-audioPlay sounds from files and URLs with play, pause, seek, loop and volume, and a hook for components.
"audio"import pyxpo_audio as Audiouse_audio_playercreate_audio_playerAudioPlayerpyxpo-drawing-canvasA finger and pen drawing view with undo, redo, clear and PNG or JPEG export.
"drawing-canvas"import pyxpo_drawing_canvas as DrawingCanvasDrawingCanvasundoredoclearget_strokes_asyncset_strokes_asyncto_image_asyncpyxpo-whiteboardA full whiteboard: pen, marker, eraser, fill, nine shapes, page patterns, undo, a ready toolbar and export.
"whiteboard"import pyxpo_whiteboard as WBWhiteboarduse_whiteboardWhiteboardToolbarto_image_asyncset_elements_asyncpyxpo-mesh-viewPlay a picture bent by a triangle mesh frame by frame on the GPU, and export it to MP4 or GIF.
"mesh-view"import pyxpo_mesh_view as MeshViewMeshViewwrite_meshread_headerexport_asyncexport_planpyxpo-sharingOpen the native share sheet for files, images, links and text.
"sharing"from pyxpo_sharing import Share, SharingShare.shareSharing.shareAsyncSharing.isAvailableAsyncpyxpo-applicationThe installed app's name, id, version, build number, install time and signing details.
"application"import pyxpo_application as Applicationapplication_namenative_application_versionget_installation_time_asyncget_android_idget_ios_application_release_type_asyncpyxpo-deviceBrand, model, OS, memory, phone or tablet, uptime and Android system features.
"device"import pyxpo_device as Devicemodel_nameos_versiondevice_typetotal_memoryget_uptime_asynchas_platform_feature_asyncpyxpo-hapticsTaps, success and error buzzes, selection ticks and the Android system haptics.
"haptics"import pyxpo_haptics as Hapticsimpact_asyncnotification_asyncselection_asyncperform_android_haptics_asyncpyxpo-localizationThe user's languages, region, currency, number separators, time zone and clock style.
"localization"import pyxpo_localization as Localizationget_localesget_calendarsuse_localesuse_calendarspyxpo-networkConnection type, online or offline, internet reachability, IP address and live changes.
"network"import pyxpo_network as Networkget_network_state_asyncuse_network_stateadd_network_state_listenerget_ip_address_asyncpyxpo-locationCurrent and live position, compass heading, geocoding both ways and permission hooks.
"location"import pyxpo_location as Locationrequest_foreground_permissions_asyncget_current_position_asyncwatch_position_asyncget_heading_asyncreverse_geocode_asyncpyxpo-fetchHTTP requests with the web fetch API: streaming bodies, abort, timeouts, redirects and cookies.
"fetch"from pyxpo_fetch import FetchError, fetchfetchResponseHeadersAbortControllerFetchErrorpyxpo-web-browserIn-app browser with a colored toolbar, OAuth sign-in sessions and Custom Tabs warm-up.
"web-browser"import pyxpo_web_browser as WebBrowseropen_browser_asyncopen_auth_session_asyncdismiss_browserwarm_up_asyncpyxpo-dot-env.env files per build mode, typed getters, and a build that stops when a secret would ship.
"dot-env"from pyxpo_dot_env import envenvEnvEnvErrorPREFIXpyxpo-notificationsLocal notifications, schedules, taps, Android channels and remote push through APNs and FCM.
"notifications"import pyxpo_notifications as Notificationsrequest_permissions_asyncschedule_notification_asyncset_notification_handleradd_notification_response_received_listenerset_notification_channel_asyncget_device_push_token_asyncpyxpo-google-mobile-adsAdMob banner, native, interstitial, rewarded and app open ads, with consent and settings for apps for children.
"google-mobile-ads"import pyxpo_google_mobile_ads as AdsBannerAdNativeAdInterstitialAdRewardedAdRewardedInterstitialAdAppOpenAduse_rewarded_adconsentinitialize_asyncThree packages store data. Pick by what you keep.
Synchronous reads, hooks that re-render on change. Not encrypted.
Tokens, passwords, API keysEncrypted by the Keychain or Keystore. Optional biometrics. A few KB per value.
Documents, downloads, large dataAny size, any format. Folders, copy, move and downloads.
Packages pass plain file URIs to each other, so a full photo flow is a few lines of Python.
Package referencefrom pyxpo_image_picker import ImagePicker
from pyxpo_image_manipulator import ImageManipulator
from pyxpo_media_library import MediaLibrary
from pyxpo_sharing import Share
async def edit_photo():
res = await ImagePicker.launchImageLibraryAsync()
if res["canceled"]:
return
out = await ImageManipulator.manipulateAsync(
res["assets"][0]["uri"], [{"resize": {"width": 1080}}],
)
if (await MediaLibrary.requestPermissionsAsync(writeOnly=True))["granted"]:
await MediaLibrary.saveToLibraryAsync(out["uri"])
await Share.share({"url": out["uri"]})A module is a pip package with Python code, a small manifest and optional Swift and Kotlin sources. Publish it to PyPI and any pyxpo app can use it.
Read the guide[project.entry-points."pyxpo.modules"]
haptics = "pyxpo_haptics"