Instagram Bot for @circumferencedividedbydiameter

⚠️ ACCOUNT SUSPENDED ~ after 10k posts

This account has been permanently suspended by Instagram/Meta for allegedly violating their "Community Standards" - despite posting nothing but the mathematical constant Pi, one digit at a time.

What exactly did Instagram find objectionable about the number 3.14159...? Your guess is as good as mine.

The Timeline

1. Initial Suspension - Account suspended for unspecified "Community Standards" violations (see screenshot)
2. Permanent Disable Notice - Account permanently disabled after review, still citing mysterious violations (see screenshot)
3. Appeal Submitted - Appeal filed on October 18, 2025 (see screenshot)
4. Outcome - [To be determined, but expectations are low]

I condemn Instagram/Meta

This project now stands as both a technical experiment and a cautionary tale about the unchecked power of social media platforms to silence users without justification, transparency, or accountability.

---

This bot is created to post automated content on Instagram. It is was currently dedicated to posting the digits of Pi sequentially to the account: @circumferencedividedbydiameter [SUSPENDED].

📖 Table of Contents

• About
• Features
• Prerequisites
• Installation
• Usage
• Configuration
• Contributing
• License

🌟 About

This project came about due to the lack of official Instagram APIs suitable for this type of automation. As such, it relies on reverse-engineered methods to interact with Instagram. While the underlying code has the capability for more general Instagram automation tasks (like those listed in Features), its current primary function and development focus is to systematically post the digits of Pi.

This means that while functional, it may be sensitive to changes made by Instagram to their private API or web interface.

✨ Features

The bot currently supports the following for the designated account:

• Post Count Retrieval: Can fetch the exact number of posts for the configured account.
• Automated Posting: Allows placing new posts (e.g., digits of Pi) with captions to the Instagram account.

(The core logic could be adapted for other automated posting tasks with modifications.)

🛠 Prerequisites

To use this bot, you'll likely need:

• Python 3.8+ (or the specific version used in the dev branch)
• An active Instagram account (the one you intend to automate, e.g., @circumferencedividedbydiameter)
• Pip (Python package installer)

⚙️ Installation

Follow these steps to set up the bot, focusing on the dev branch:

1. Clone the repository (dev branch):

   git clone -b dev https://github.com/verynewusername/instagrambot.git
   cd instagrambot

2. Install dependencies: This project likely uses a requirements.txt file to manage Python dependencies. Install them using pip:

   pip install -r requirements.txt

   (If your project uses a different dependency manager like Poetry or Pipenv, please update this section accordingly.)

3. Set up environment variables: Create a .env file in the root directory of the project. This file will store your Instagram credentials securely. You can often create this by copying an example file if one is provided (e.g., cp .env.example .env).

   Add the following variables to your .env file:

   INSTAGRAM_USERNAME="your_instagram_username"
   INSTAGRAM_ENCRYPTED_PASSWORD="your_captured_encrypted_password"

   Important Note on INSTAGRAM_ENCRYPTED_PASSWORD: This is not your plain text Instagram password. You need to capture this encrypted password string from a legitimate login request made through a web browser. You can do this using your browser's developer tools (usually by pressing F12) and inspecting the network requests made during the Instagram login process. Look for the request that sends your credentials, and you should find the encrypted password in the payload. The specific encryption method is handled by Instagram, and this bot utilizes that already encrypted form. Once captured, this encrypted password should remain valid as long as your actual Instagram password does not change.

🚀 Usage

After installation and configuration, you can typically run the bot using its main script.

If the main script is main.py (a common convention), you would run it like this:

python main.py

🔧 Configuration

The primary configuration for this bot is handled through environment variables, which should be placed in a .env file in the project's root directory, as described in the Installation section.

Required Environment Variables:

• INSTAGRAM_USERNAME: The username of the Instagram account the bot will control.

  • Example: INSTAGRAM_USERNAME="circumferencedividedbydiameter"

• INSTAGRAM_ENCRYPTED_PASSWORD: Your Instagram password for the specified account, but in its encrypted form as captured from a browser session.

  • How to obtain: As detailed in the Installation section, this encrypted string must be captured from a web UI HTTP request during a successful login to Instagram.
  • Persistence: Once obtained, this encrypted password can be reused as long as your actual Instagram password remains unchanged.
  • Example Format (your actual captured password will vary): INSTAGRAM_ENCRYPTED_PASSWORD="'#PWD_INSTAGRAM_BROWSER:11:1111111111:..." (The string will be much longer and contain a mix of characters).

🤝 Contributing

While the bot is currently focused on posting digits of Pi, contributions that enhance its core functionality or improve its robustness are welcome. If you'd like to contribute:

1. Fork the repository.
2. Create a new branch for your feature or fix (git checkout -b feature/your-amazing-feature or git checkout -b fix/some-bug).
3. Make your changes and commit them with clear messages (git commit -m 'Add amazing feature').
4. Push your changes to your forked repository (git push origin feature/your-amazing-feature).
5. Open a Pull Request back to the dev branch of the verynewusername/instagrambot repository.

(Consider adding notes on coding style, running tests, or any specific contribution guidelines if you have them.)

📄 License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

What this means:

• ✅ You can use, share, and modify this code for non-commercial purposes
• ✅ You must provide attribution to the original creator
• ✅ Any modifications must be shared under the same license
• ❌ Commercial use requires separate permission

For the full license text, see the LICENSE file.

---

Built with ❤️ by @verynewusername Currently posting the infinite wisdom of Pi, one digit at a time.