Delete this section of the document once the app development is done, before publishing the repository.
This skeleton code is a scaffolding for Python-based CLAMS app development. Specifically, it contains
app.py
andmetadata.py
to write the apprequirements.txt
to specify python dependenciesContainerfile
to containerize the app and specify system dependencies.gitignore
and.dockerignore
files listing commonly ignored files- an empty
LICENSE
file to replace with an actual license information of the app - This
README.md
file for additional information not specified in the general user manual at https://apps.clams.ai/clamsapp - A number of GitHub Actions workflows for issue/bug-report management
- A GHA workflow to publish app images upon any push of a git tag
- NOTE: All GHA workflows included are designed to only work in repositories under
clamsproject
organization.
- NOTE: All GHA workflows included are designed to only work in repositories under
Before pushing your first commit, please make sure to delete this section of the document.
Then use the following section to document any additional information specific to this app. If your app works significantly different from what's described in the generic readme file, be as specific as possible.
warning TO_DEVS: Delete these
TO_DEVS
notes and warnings before publishing the repository.
warning TO_DEVS: Again, delete these
TO_DEVS
notes and warnings before publishing the repository.
note TO_DEVS: A brief description of the app, expected behavior, underlying software/library/technology, etc.
General user instructions for CLAMS apps is available at CLAMS Apps documentation.
Below is a list of additional information specific to this app.
note TO_DEVS: Below is a list of additional information specific to this app.
note TO_DEVS: Any system-level software required to run this app. Usually include some of the following:
- supported OS and CPU architectures
- usage of GPU
- system package names (e.g.
ffmpeg
,libav
,libopencv-dev
, etc.)- some example code snippet to install them on Debian/Ubuntu (because our base images are based on Debian)
- e.g.
apt-get update && apt-get install -y <package-name>
For the full list of parameters, please refer to the app metadata from CLAMS App Directory or metadata.py
file in this repository.
warning TO_DEVS: If you're not developing this app for publishing on the CLAMS App Directory, the above paragraph is not applicable. Feel free to delete or change it.
note TO_DEVS: all runtime parameters are supported to be VERY METICULOUSLY documented in the app's
metadata.py
file. However for some reason, if you need to use this space to elaborate what's already documented inmetadata.py
, feel free to do so.