Update README.md
Browse files
README.md
CHANGED
|
@@ -1,3 +1,88 @@
|
|
| 1 |
-
---
|
| 2 |
-
license: mit
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: mit
|
| 3 |
+
language:
|
| 4 |
+
- en
|
| 5 |
+
---
|
| 6 |
+
# Aparecium Seq2Seq Reverser Model
|
| 7 |
+
|
| 8 |
+
This model is part of the [Aparecium](https://github.com/SentiChain/aparecium) project, designed to reveal text from embedding vectors, particularly for SentiChain embeddings.
|
| 9 |
+
|
| 10 |
+
## Model Description
|
| 11 |
+
|
| 12 |
+
The Seq2Seq Reverser model is a specialized sequence-to-sequence model trained to reconstruct original text from embedding vectors, with a particular focus on crypto market-related content.
|
| 13 |
+
|
| 14 |
+
### Training Data
|
| 15 |
+
|
| 16 |
+
- **Dataset Size**: 10,000 sentences
|
| 17 |
+
- **Data Source**: Generated using OpenAI's API
|
| 18 |
+
- **Domain**: Cryptocurrency market events and related content
|
| 19 |
+
- **Language**: English
|
| 20 |
+
|
| 21 |
+
### Limitations
|
| 22 |
+
|
| 23 |
+
⚠️ **Important Note**: This model is specifically trained on cryptocurrency market-related content. Its performance may be significantly limited when:
|
| 24 |
+
- Processing text from other domains
|
| 25 |
+
- Handling general-purpose text
|
| 26 |
+
- Working with technical content unrelated to crypto markets
|
| 27 |
+
|
| 28 |
+
### Model Architecture
|
| 29 |
+
|
| 30 |
+
The model uses a sequence-to-sequence architecture with:
|
| 31 |
+
- Encoder-decoder transformer architecture
|
| 32 |
+
- Specialized tokenizer for crypto market terminology
|
| 33 |
+
- Optimized for embedding vector reconstruction
|
| 34 |
+
|
| 35 |
+
## Usage
|
| 36 |
+
|
| 37 |
+
The model can be used through the Aparecium Python package:
|
| 38 |
+
|
| 39 |
+
```python
|
| 40 |
+
from aparecium.models.seq2seqreverser import ModelManager
|
| 41 |
+
|
| 42 |
+
# Initialize the model manager
|
| 43 |
+
manager = ModelManager()
|
| 44 |
+
|
| 45 |
+
# The model will be automatically downloaded when needed
|
| 46 |
+
model_path = manager.get_model_path()
|
| 47 |
+
```
|
| 48 |
+
|
| 49 |
+
### Installation
|
| 50 |
+
|
| 51 |
+
```bash
|
| 52 |
+
pip install aparecium
|
| 53 |
+
```
|
| 54 |
+
|
| 55 |
+
## Performance and Limitations
|
| 56 |
+
|
| 57 |
+
The model performs best on:
|
| 58 |
+
- Cryptocurrency market news and updates
|
| 59 |
+
- Trading-related content
|
| 60 |
+
- Market analysis text
|
| 61 |
+
- Blockchain technology discussions
|
| 62 |
+
|
| 63 |
+
Performance may degrade on:
|
| 64 |
+
- General news articles
|
| 65 |
+
- Technical documentation
|
| 66 |
+
- Social media content
|
| 67 |
+
- Non-financial text
|
| 68 |
+
|
| 69 |
+
## License
|
| 70 |
+
|
| 71 |
+
This model is released under the MIT License.
|
| 72 |
+
|
| 73 |
+
## Citation
|
| 74 |
+
|
| 75 |
+
If you use this model in your research, please cite:
|
| 76 |
+
|
| 77 |
+
```bibtex
|
| 78 |
+
@software{aparecium_seq2seq_reverser,
|
| 79 |
+
title = {Aparecium Seq2Seq Reverser},
|
| 80 |
+
author = {SentiChain},
|
| 81 |
+
url = {https://huggingface.co/SentiChain/aparecium-seq2seq-reverser},
|
| 82 |
+
year = {2024},
|
| 83 |
+
}
|
| 84 |
+
```
|
| 85 |
+
|
| 86 |
+
## Contact
|
| 87 |
+
|
| 88 |
+
For issues and questions, please use the [GitHub issue tracker](https://github.com/SentiChain/aparecium/issues).
|