# Personal Habit Planner (`sheeny_pediment/personal-habit-planner`) Actor Automatically generates a dynamic, beautifully formatted Excel habit tracker and planner, including spiritual fasting days and financial tracking. - **URL**: https://apify.com/sheeny\_pediment/personal-habit-planner.md - **Developed by:** [Ram Vittanala](https://apify.com/sheeny_pediment) (community) - **Categories:** Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.05 / actor start This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Personal Habit Planner The **Personal Habit Planner** actor automatically generates a dynamic, beautifully formatted Excel spreadsheet template designed to help you track your daily habits, spiritual practices, religious fasting days, and financial goals throughout the year! ### Features - **Spiritual & Religion Support:** Automatically integrates key religious fasting days, festivals, and spiritual habits into the planner based on your selected religion (Hindu, Christian, Muslim, Jewish). - **Financial Planning Module:** Option to inject financial habits (e.g., budget reviewing, logging expenses, no-spend days) seamlessly into your daily trackers. - **Non-Spiritual Tracker:** If religion is set to 'Non-Spiritual', it provides a streamlined set of generic productivity, mindfulness, and learning trackers. - **Native Excel Charts:** Generates a 'Summary & Graphs' tab at the front of the workbook containing interactive **native bar charts**. As you check off habits with a `1` or `x` in the monthly sheets, your graphs will automatically update to visualize your progress across the year. - **Automated Email Delivery:** Enter your email address to receive the generated `.xlsx` file delivered directly to your inbox instantly. ### Input Configuration The Actor accepts the following input fields via the Apify interface: * **Spiritual/Religion Focus** `religion` (Dropdown): Choose your focus. Valid options are `Non-Spiritual`, `Hindu`, `Christian`, `Muslim`, and `Jewish`. * **Custom Habits** `customHabits` (Array): Add your own custom habits to track in the planner. * **Include Financial Planning** `includeFinancial` (Checkbox): Set to `true` to append financial tracking habits to the planner. * **Email Address** `email` (String, Optional): An email address to send the final spreadsheet to. *Note: Apify restricts the Send Email integration for free/unverified accounts to only send to your own registered Apify email address.* * **Year** `year` (Integer): The target year for the planner (e.g., `2026`). ### Output 1. **Download Link:** The actor will store the `planner.xlsx` file in the default Key-Value Store. A direct download link will be available in the Run logs upon completion. 2. **Email Attachment:** If an email is provided, the `.xlsx` file will be securely sent as an attachment. ### Template Layout The generated Excel workbook includes 13 tabs: * **Summary & Graphs:** An interactive dashboard featuring column/bar charts for each individual habit. It automatically totals the completions logged in the subsequent monthly sheets. * **Monthly Sheets (January - December):** 12 individual tabs containing rows for every calendar day, a column specifying any special religious festivals/fasting days, and checkbox columns for every habit you requested. Detailed habit descriptions are included in the headers. --- *Built using Python and XlsxWriter.* # Actor input Schema ## `religion` (type: `string`): Select the religion to include specific fasting days and festivals, or 'Non-Spiritual' for general habit trackers. ## `customHabits` (type: `array`): Add your own custom habits to track in the planner. ## `includeFinancial` (type: `boolean`): If checked, adds financial planning and tracking habits (e.g., budget review, expense tracking). ## `email` (type: `string`): If provided, the generated Excel/PDF template will be sent to this email. ## `year` (type: `integer`): The year to generate the planner for ## Actor input object example ```json { "religion": "Non-Spiritual", "includeFinancial": false, "year": 2026 } ```` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("sheeny_pediment/personal-habit-planner").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("sheeny_pediment/personal-habit-planner").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call sheeny_pediment/personal-habit-planner --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sheeny_pediment/personal-habit-planner", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Personal Habit Planner", "description": "Automatically generates a dynamic, beautifully formatted Excel habit tracker and planner, including spiritual fasting days and financial tracking.", "version": "0.0", "x-build-id": "eP4kUATHsEq3rFECb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sheeny_pediment~personal-habit-planner/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sheeny_pediment-personal-habit-planner", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sheeny_pediment~personal-habit-planner/runs": { "post": { "operationId": "runs-sync-sheeny_pediment-personal-habit-planner", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sheeny_pediment~personal-habit-planner/run-sync": { "post": { "operationId": "run-sync-sheeny_pediment-personal-habit-planner", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "religion", "year" ], "properties": { "religion": { "title": "Spiritual/Religion Focus", "enum": [ "Non-Spiritual", "Hindu", "Christian", "Muslim", "Jewish" ], "type": "string", "description": "Select the religion to include specific fasting days and festivals, or 'Non-Spiritual' for general habit trackers.", "default": "Non-Spiritual" }, "customHabits": { "title": "Custom Habits (Optional)", "type": "array", "description": "Add your own custom habits to track in the planner.", "items": { "type": "string" } }, "includeFinancial": { "title": "Include Financial Planning", "type": "boolean", "description": "If checked, adds financial planning and tracking habits (e.g., budget review, expense tracking).", "default": false }, "email": { "title": "Email Address (Optional)", "type": "string", "description": "If provided, the generated Excel/PDF template will be sent to this email." }, "year": { "title": "Year", "type": "integer", "description": "The year to generate the planner for", "default": 2026 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```