Instructions to use zachtheyek/aetherscan with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Keras
How to use zachtheyek/aetherscan with Keras:
# Available backend options are: "jax", "torch", "tensorflow". import os os.environ["KERAS_BACKEND"] = "jax" import keras model = keras.saving.load_model("hf://zachtheyek/aetherscan") - Notebooks
- Google Colab
- Kaggle
Aetherscan
Breakthrough Listen's deep-learning SETI pipeline: a two-stage architecture where a Beta-VAE encoder compresses each observation of a 6-observation cadence (3 ON / 3 OFF, ABACAD) into an 8-dimensional latent, and a Random Forest classifies the cadence's concatenated latents as a technosignature candidate or not.
This repository carries the released model weights at stable filenames, versioned via git
tags: training tags match the pipeline run's save tag (e.g. final_v3), and release tags
(vX.Y.Z) mark blessed weights.
Training tag: test_v26
Files
| File | Description |
|---|---|
vae_encoder.keras |
Beta-VAE encoder (Keras) โ the inference feature extractor |
vae_decoder.keras |
Beta-VAE decoder (Keras) โ for reconstruction/traversal analysis |
random_forest.joblib |
Random Forest cadence classifier (joblib) |
config.json |
Full resolved training configuration for this run |
Training configuration
| Parameter | Value |
|---|---|
| Training rounds | 2 |
| Epochs per round | 2 |
| Beta-VAE samples per round | 200 |
| Random Forest samples | 200 |
| Curriculum schedule | exponential |
| SNR base | 10 |
| Initial SNR range | 40 |
| Final SNR range | 10 |
| Latent dimensions | 8 |
| Beta (KL weight) | 1.5 |
| Alpha (clustering weight) | 10.0 |
| RF estimators | 1000 |
The complete configuration is in config.json.
Evaluation (validation split)
| Metric | Value |
|---|---|
| ROC AUC | 0.7812 |
| Average precision | 0.7904 |
| Classification threshold | 0.99 |
| Validation samples | 40 |
Library versions
| Library | Version |
|---|---|
| python | 3.12.3 |
| tensorflow | 2.17.0 |
| numpy | 1.26.4 |
| scikit-learn | 1.5.2 |
| huggingface_hub | 1.21.0 |
Usage
Aetherscan inference downloads these weights by default when no local artifact paths are
given (pin a version with --hf-revision):
python -m aetherscan.main inference --hf-revision test_v26 --inference-files <catalog.csv>
Links & citation
Source code, documentation, and issue tracker: https://github.com/zachtheyek/Aetherscan.
If you use Aetherscan in your research, please cite it via the repository's CITATION.cff.
- Downloads last month
- 61