Asynmov: A Python Package for Generating Synthetic Data for American Historical Fiction World Building

Asynmov is a powerful and flexible Python package designed to assist writers, game developers, and storytellers in creating rich, immersive American historical fiction worlds set in the 19th, 20th, and 21st centuries. By generating synthetic data based on real-world historical events, cultures, and societies, Asynmov enables you to effortlessly generate a wide range of realistic and consistent data points to bring your fictional worlds to life.

Features

Entities

• Character Generation: Create detailed character profiles with names, ages, backgrounds, occupations, education, and more, based on historical American demographics and social structures.

Events

• Core Life (Vital) Events:

  • Birth events with historically accurate naming conventions and family structures.
  • Death events reflecting historical American life expectancies and mortality rates.
  • Marriage events based on historical American customs, laws, and social norms.

• Vocation Events:

  • Occupation events based on historical American professions, industries, and labor markets.
  • Education events reflecting historical American literacy rates, schools, and higher education institutions.
  • Military service events based on historical American conscription, wars, and conflicts.

• Avocation Events:

  • Religious events based on historical American beliefs, practices, and movements.
  • Cultural events reflecting historical American arts, music, literature, and entertainment.
  • Sports and leisure events based on historical American pastimes, games, and recreation.

• Relocation Events:

  • Migration events based on historical American patterns of settlement, urbanization, and immigration.
  • Urbanization events reflecting historical American growth of cities and rural-to-urban migration.
  • Travel events based on historical American transportation networks, road trips, and vacations.

• Upheaval Events:

  • War and conflict events based on historical American battles, campaigns, and home front experiences.
  • Natural disaster events reflecting historical American earthquakes, hurricanes, and other catastrophes.
  • Political events based on historical American elections, scandals, and social movements.

Relationship Development

• Social Network Generation: Create historically accurate social networks based on American family structures, communities, and social organizations.
• Relationship Dynamics: Model the evolution of relationships over time based on historical American social norms, courtship, and marriage patterns.

World Building Utilities

• Historical Timeline Generation: Construct plausible historical events, timelines, and chronologies for your fictional American world based on real-world historical patterns and causality.
• Cultural and Social Systems: Develop intricate cultural and social systems, such as regional dialects, subcultures, political parties, and economic systems, based on historical American anthropology and sociology.
• Technology and Innovation: Generate historically accurate technology levels, inventions, and scientific discoveries based on real-world American technological progression.
• Data Export: Export the generated data in various formats, such as JSON and CSV, for easy integration into other tools and platforms.

Feature Pipeline

• Geographic Generation: Generate convincing historical American maps, landscapes, and geographic features based on real-world terrain, climate, and ecosystems.
• Alternate History Scenarios: Explore "what if" scenarios by altering key events in American history and generating plausible alternate timelines and outcomes.
• Customizable Templates: Customize and extend the generated data using user-defined templates, rule sets, and historical American databases.

Installation

To install Asynmov, simply use pip:

pip install asynmov

Usage

Here's a quick example of how to use Asynmov to generate a historically accurate American character profile:

from asynmov import AmericanCharacterGenerator

generator = AmericanCharacterGenerator(era="1920s", region="midwest")
character = generator.generate_character()

print(character)

Output:

{
  "name": "Dorothy Fairfield",
  "age": 24,
  "gender": "Female",
  "occupation": "Typist",
  "education": "High School Diploma",
  "background": "Dorothy grew up on a small farm in rural Indiana. After graduating from high school, she moved to Chicago to pursue a career as a typist. She enjoys the bustling city life and dreams of one day traveling the world."
}

For more detailed usage instructions and examples, please refer to the documentation.

Contributing

We welcome contributions from the community! If you'd like to contribute to Asynmov, please follow these guidelines:

1. Fork the repository and create a new branch for your feature or bug fix.
2. Ensure your code adheres to the project's coding style and standards.
3. Write clear, concise, and well-documented code.
4. Test your changes thoroughly to ensure they do not introduce new bugs.
5. Submit a pull request, describing your changes and the problem they solve.
6. Be responsive to feedback and be willing to make changes to your pull request if necessary.

By contributing to Asynmov, you agree that your contributions will be licensed under the project's MIT License.

License

Asynmov is open-source software licensed under the MIT License.

Support

If you have any questions, issues, or suggestions, please reach out to us on GitHub by opening an issue or by contacting the maintainers directly through their GitHub profiles.

Happy American historical world building with Asynmov!